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This siizimary is Intended i" the experienced author rho nee^ qujic 
reference far the form of a tag and for some of the resrr .ctions eoniria' 

It does not dscuss fine detail::^ of the TUTOR language, "or sue . forn - 

authors should refer to "aids" and to The TUTO. Language Brucr. S: 

Each coEimand Includes a brief description of its pur: se 
tion of the tag. The standard form is 

command brief description 

command DESCRIPTION OF TAG (any explanator ocmi». f 

or 

command actual tag 

Note: Additional comments about this comrrar 
NOTE: General comments about groups of commands. 



The commands are grouped into nine categories: calculatin: (^;) 
data keeping (D), file operations (F), judging (J), managing si* , 
presenting (P), routing (R), sequencing (S), terminal resident i lag 'T). 

Commands v?hlch are difficult to classify are placed in categori 
describe their jiost probable use. 

Modifications to this book required by changes in the TUTOV are 
contained in lesson "aids" (press DATA and type: changes to sumna. Zhsse 

modifications, along with other notes of interest, may be Inser ir. ^ spaces 
which have been provided between entries and on the additional z r e end 

of each section. 
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Abbreviations and Notes 
Belov: lire lister, "he abbreviations used In the cescrlpti ' n: 



atbrevlatl: 


deflnltlc: 




argument : nag entry 




blank ta^ 


::oarse 


character jrid coordinates 


:m 


central msmory 


CPU 


central processing unit 


iisk 


rotating magnetic disk storage it:. 


ECS 


extended core storage 


expr 


mathematical expression 


f inex,f Iney 


fine grid coordinates 




number uf 


(opt) 


optional argumenv^- 


ppt 


programmable terminal (1ST and ?T^T) 


string 


character string 


var 


variable 


vars 


varlablv^ 



conditional sta ats and in statements where a variable is set, suffixes 
L 0, i, 2, etc., te the minus condition, 0 condition, 1 condition, 

1 condition, etc, g., 

ma t ch VAR , WORD 0 , WORD 1 , WORD 2 

do EXPR , NAMEM , NAME 0 , NAME 1 , NAME 2 

In conditional staiie^aents the conditional expression is rounded (not truncated) 
to the nearest int^-^er. Thus, a value of -.4 results in the 0 condition Deing 
selected rather than the minus condition. 

Generally, wherever a tag entry may be a number j, a mathematical expression 
will also be accepted. 

Command names are enclosed in dashes when they are referred to in descriptions, 
e.g., -next-. Names of system variables are enclosed in double quotes,, e.g*, 
"zreturn". Key names are capitalized, e.g., NEXT. A function key name followed 
by "1", e.g., NEXri, indicates the SHIFT key is held while the key is pressed. 

A word which is enclosed in single quotes designates information which is 
stored left-justified in a variable, e.g., 'student* . 

Commands labeled "non-executable" are active only when the lesson is being 
condensed and not during execution. 

When variables are used in the tag of certain commands which require name^ 
in the tag, e.g., -area-, the variable must be enclosed in parentheses to 
indicate that the information needed is the contents of the variable and not 
a character string; e.g., -area (v3)- means the area whose name is contained 
in variable v3, while -area v3- mear^s the area whose name is v3. 
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seed 
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remove 

restore 
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Information C10 

clock 

date 
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compute 



Bit and character manipulation Cll 

search 

pack 
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move 
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otoa 

htoa 

clean 

recname 



Dai a :-nanipulation CI S 
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initial 
storage 
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release 
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System variables for calculating C22 
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zcpw 

zcusers 
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10 



ERIC 



V 



JUDGING 



Preparation for 
responding Jl 

eraseu 

force 

edit 

arrow 

arrowa 

arheada 

long 

jkey 

copy 

endarrow 



Vocabulary lists J4 

list 
endings 
vocabs 
vocab 



Modification of judging 
copy of response J5 

bump 

put 

putd 

putv 

close 

loada 



Modification of judging 
procedure J6 

specs 



Storing judging copy of 
response J8 

store 

storeu 

storen 

storea 

open 



Matching judging 

copy of response J9 

match 

answer 

wrong 

an s we re 

wrongc 

concept 

miscon 

exact 

exactc 

exactv 

ansv 

wrongv 

ansu 

wrongu 

touch 

touchw 

or 

ans 



Information on specific 
words in response J13 

getword 
getmark 
getloc 
compare 

Unconditional judgment J15 

ok 
no 

ignore 

Reference to other units 
which may contain 
judging commands J16 

join 

iarrow 

iarrowa 



Alteration of 
judgment Jl 7 

judge, 

Alteration of 
feedback J18 

okword 
noword 
markup 
markupy 

System variables 

for jr.dging J 19 H 

judging in general 

anscnt 
ansok 
j count 
judged 
key 
ntries 
ztouchx 
z touchy 

verbal responses 

capital 

entire 

extra 

order 

phrase 

spell 

vocab 

wcount 

numerical responses 

opcnt 
varcnt 
f ormok 



11 



vi 



MANAGING SITES 



Site commands Ml 



Station commands M3 



site set 

site Info 

site active 

rite stations 



station 
station 
station 
station 
station 
station 
station 



Info 

status 

send 

logout 

stopl 

off 

on 



12 



ERIC 



vll 



PRESENTING 



Basic display PI 


Relocatable graphics P8 


Non-screen P16 


at 


rorigin 


slide 


atnm 


rat 


audio 


write 


r a turn 


play 


wri t ec 


rdot 


record 


show 


rdraw 


enable 


showz 


rbox 


disable 


showt 


rvector 


ext 


showe 


rcircle 


extout 


showo 




xout 


shown 




xin 


showa 


Drawing graphs P10 


beep 


hidden 




say lang 


text 


gorigin 


say 


erase 


axes 


sayc 


lang 


bounds 




mode 


scalex 




size 


scaley 


Special display P19 


rotate 


Iscalex 




delay 


Iscaley 


tabset 


inhibit 


labelx 


micro 


char 


labely 


charset 


plot 


markx 


chartst 




marky 


lineset 




polar 


altf ont 


Graphics P6 


gat 






gatnm 




dot 


gdot 


System variables 


draw 


graph 


for presenting P; 


box 


gdraw 




fill 


gbox 


mode 


vector 


gcircle 


size 


window 


gvector 


' sizex 


circle 


vbar 


sizey 


circleb 


hbar 


where 




delta 


wherex 




funct 


wherey 



zlang 



ERIC 



viii 



ROUTING 



Router lesson Rl 



System variables for routing R3 



route 

routvar 

allow 



Curriculum information R2 

lesson 

score 

status 



errtype 

Idone 

Iscore 

Istatus 

rcallow 

router 

rstartl 

rstartu 

rvallow 

zleserr 



ERIC 



SEQUENCING 



Basic sequencing SI Timing S9 System variables 

for sequencing S21 



unit 


keylist 




unitop 


pau se 


args 


entry 


collect 


bac kout 




getcode 


baseu 




keytype 


clock 
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z touchy 
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Lesson annotation 
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and debugging 817 
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change 






step 






*list 





H 



1 



X 



Loading and running Tl 

ptutor 

unit 

loadu 

runu 

haltu 
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wrongc 
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or 

if match 
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• 



CALCULATING 



Basic calculating 

» 

define (non-e::ecutable) permits an author to rename variables and to define 
matheiLatlcal functions, arrays, and constants for a lesson and to 
specify those available for student use; defined variables must 
physically precede any reference to the variables in the lesson 

for example: 

define DEFNAME 

NAMEl«vl,NAME2«n2,NAME3«65,NAME4«2 (NAMEl-rtJAME3) , . * • 
FUNC(x,y, • • • )**some function of x, y> etc., where x, y, etc. 
are not already defined, although the expression on the right 
of the equal sign may contain previously defined names 
(up to 6 arguments are permitted) 

The following definitions allow use of segmented varliLies* 

segment, NAME^STARTING VAR,NUM BITS PER BYTE,s (opt) 
segmentv,NAME«STARTING VAR, STARTING BIT POSITION, 
NUM BITS PER BYTE,s (opt) 
(Starting variable address and byte size cannot be 
variables- Byte size Is from 1 to 59. If the last 
argument Is included, negative as well as positive integers 
may be stored • In vertical segment, starting bit position 
may be from 1 to 60.) 

The following definition sets up a field of less than 60 bits. 

segmentf,NAME«VAR, STARTING BIT POSITION, NUM BITS,s (opt) 
(Restrictions are those for segmented variables • 
Field variables are not indexed-) 

The following definitions allow use of arrays. 

array,NAME(SIZE)=STARTING VAR (SIZE gives number of 

variables required) 
arra7,NAME(NUM ROWS, NUM COLUMNS )«STARTING VAR 
(inamber of variables equals rows x columns) 
array, NAME (FIRST ELEMENT;LAST ELEMENT )«S TART ING VAR 
array, NAME (FIRST ROW ELEMENT, FIRST COLUMN ELEMENT ;LAST 
ROW ELEMENT, LAST COLUMN ELEMENT )«S TART ING VAR 

Arrays may also be defined with segmented variables «> The form is 
that for vertical segments. For example: 

arraysegv,NAME(SIZE)«STARTING VAR,STARTING BIT POSITION, 
NUM BITS PER BYTE,s (opt) 

Up to 255 elements are permitted in an array, 
(-define- continued on next page.) 
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define student 

all defines necessary for student responses, Including units 

units, UNITl, UNIT2,, • . (maximum of 10 units, such as gram, 

meter, second, • • • ) 
(The define set "student" may also Include abbreviations 
and equivalences Involving these units* Sae -storeu-, 
-ansu-, and -wrongu- for these applications.) 

To merge a previous set of definitions (SETA) with a set being 
defined at this point in the program (SETB): 

define SETB > SETA 

definitions in SETB 

To purge previous define sets: 

define purge ,DEFNAME (discards define set named) 

define purge (discards all define sets except "student") 

Note: Approximately 1500 definitions are permitted in active define 
sets, fewer if definitions are complicated, (Define set 
"student" may contain approximately 500 definitions.) Defined 
names and names of define sets cannot exceed 7 characters, 
cannot contrln mathematical operators, and must start with a 
letter. Up to 3 define sets may be referenced. When a 6th set 
is activated, all earlier sets except "student" are discarded. 

A local define set may be declared as a continuation of a -unit- 
command. (The -define- command is omitted*) Features described 
above are available. In addition, local variables may be declared. 
Sample formats for local variables are: 

unit someu 

NAME 1 , NAME 2 , NAME 3 ( S IZ E ) 
NAME4»C0NSTANT 

floating:NAME5,NAME6, NAME? (SIZE) 
integer, NUM BITS: NAMES, NAME9 
integer ,NUM BITS,signed:NAME10 
integer:NAMEll 

To merge the local define set with the "global" define set: 

unit someu 

merge ,DEFNAME (merges with the define set named) 

or 

unit someu 

merge , previous (merges with the previous define set) 
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Ivars (non-executable) sets up a buffer In memory for local variables for 
the lesson; required If the lesson uses local variables; must appear 
in the ieu before any references to a unit 

Ivars SIZE OF BUFFER (maximum size of 128) 



calc assigns the value of the expression on the right side of the assign 
arrow to the variable or array on the left side, or packs up to 10 
characters into an integer variable 

for example: 

calc VAR<= EXPR 

calc VAR^ "STRING" (right-justified, use n-variable) 
calc VAR<t 'STRING* (left-justified, use n-variable) 
calc ARRAYNAME^ EXPR (includes standard arithmetic operations, 
bit operations, and logical operations on entire arrays 
and on array elements, and array functions operating on 
entire arrays') 
calc VAR<= ARRAYNAMEl o ARRATOAMEZ 
calc ARRAYNAME1<= ARRAYNAME2 X ARRAYNAME3 

Note: See section on SEQUENCING, Automatic sequencing for -doto-, 
-branch-, -if-, -loop-, and related directives- These are 
calc-type commands which allow branching withir a unit. 



calcc does one of several calculations depending on the rounded value 
of a conditional expression 

calcc EXPR,VAR1<= EXPRM,VAR2«: EXPR0,VAR3<= EXPRl, ,VAR4<= EXPR3 



calcs sets a variable to one of several values depending on the rounded 
value of a tconditional expression 

calcs EXPR,VAR<= EXPRM, EXPR0, EXPRl, EXPR2, ,EXPR4 



NOTE: Up to 61 calculations may be performed with -calcc- or -cal-s- 
A blank tag entry (,,) means no calculation is done for the 
corresponding value of the conditional expression* 

addl adds 1 to the specified variable; can be used with array elements 
but not with entire arrays 

addl VAR 
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subl subtracts 1 from the specified variable; can be used with array 
elements but not with entire arrays 

sub 1 VAR 



zero sets to zero a single variable or a set ;ecu..ive variables; 

can be used with array elements but not atlre arrays 

zero VAR 

zero STARTING VAR,NUM VARS (cannot be used with segmented 

variables or segmented arrays) 



set sets values of consecutive variables starting at the specified 

variable, or sets values of matrix elements starting at the 
specified element (starts at the first element if no element is 
specified); can be used to set segmented arrays but not segmented 
variables 

set STARTING VAR<» VALUEl, VALUE2, VALUE3, ... 

set ARRAYNAME'i!' VALUE 1, VALUE2, VALUE3, . 

set ARRAYNAMECWW, COLUMN )<= VALUEl, VALUE2, VALUE3, . 

Note: Up to 61 values may be set with a single -set- command- 
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Operations and symbols used in calculations 
addition + 
subtraction 

multiplication x or * (impliea multiplication is permitted, e.g., 5a) 

division t or / 

dot product of two arrays ® 

cross product of two arrays X 

parentheses, brackets (),[]?{> 

exponentiation ** or superscript or shift-superscript (e.g., a^) 
assignment of a value to a variable ^ 
TT = pi = 3. 14159. .. 

° = degree sign; indicates a number is interpreted in degrees, e.g., 30^; 
number x 1® converts number to radians; 
number t 1° converts number to degrees 

Address of a variable may be an expression; i.e., v(EXPR) is permitted, 
where EXPR is rounded to the nearest integer. 

Precedence of operations (in brief) 
operations within parentheses 
exponentiation 
multiplication 
division 

addition and subtraction 

In general with anything but very simple expressions, parentheses should 
be used freely. 

NOTE: The computer has approximately 14-digit accuracy. 

Values of floating-point numbers range from about ±10""293 ^.q ^10+322^ 
Values of integers range from about -10^^ to +10^^. 

However, multiplication and division of large integer values may give 
erroneous results because of limitations on integer arithmetic* 

ERIC r.. 
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system functions (argument may be an expression) 



abs(X) 
arctan(X) 

cos(X) 
exp(X) 

f rac(X) 
int(X) 

log (X) 
ln(X) 
round (X) 
sign(X) 
sin(X) 
.sqrt(X) 
varloc(X) 

zfinex(X) 
zf iney(X) 



absolute value of X 

inverse tangent, result in radians, range -7r/2 to +7r/2; 
for result in degrees, use arctan(X)/l° 

cosine of X, X in radians; use cosCX"") when X is in degrees 



fractional part of 
integer part of X 



} 



X is first rounded to the nearest integer 
if X is within 10""^ of the integer for 
|X|<100 or within (10"llx|X|) of the 
integer for |X|>100 (approximately) 
(base 10) 
(base e) 



common logarithm of X 
natural logarithm of X 
rounded value of X 

= -1 for X < -10"9; = 0 for -10'"9 ^ x < 10-9; = +1 for X > 10"^ 
sine of X, X in radians; use sin(X®) when X is in degrees 
square root of X 

address of variable X (X may be a student variable, central memory 
variable, router variable, or defined variable) 
fine-grid x location of character-grid location "X" 
fine-grid y location of character-grid location "X" 



Logical operations and functions (logical "true" is -1; logical "false" is 0) 



« Y 
5^ Y 

< Y 

> Y 

< Y 

> Y 
X$and$Y 
X$or$Y 
not(X) 



equal to 

not equal to 

less than or equal to 

greater than or equal to 

less than 

greater than 

logical "and"; result is 



equality ±s "true" if 

|X-Y|<10-5 for |X|<100 or 

if |X-Y|<(irrllx|X|) for |X!>100 

(approximately) 



true" only if both X and Y are "true" 

f either X or Y or both are "true' 
reverse of truth value of X: if X=0, not(X)«-l; if X— 1, not(X)=0 



logical "or"; result is 



"true" 



Bit operations and functions (use with n-variables) 



X$ars$Y shifts X to the right by Y bit positions 

X$cls$Y shifts X to the left (circularly) by Y bit positions 

X$mask$Y sets bits where bits are set in both X and Y 

X$union$Y sets bits where bits are set in either X or Y or both 

X$diff$Y sets bits where bits are set in either X or 

bitGnt(X) number of bits set in X 

comp(X) one's complement of X (bit reversal) 

Imask(X) left-justified number with X bits set 

rmask(X) right-justified number with X bits set 



} 



Y but not both 



X ranges from 
0 to "zbpw" 



System functions are continued on next page. 
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Array functions 



And(X) 

Max(X) 

Min(X) 

Or(X) 

Prod(X) 

Rev(X) 

Sum(X) 

Transp(X) 



"true" (=-1) If all elements of array X are "true" 
largest element in array X 
smallest element in array X 

"true" if any element of array X is "true" 

product of all elements in array X 

reverse of array X; i«e», last element is now first, etc* 
sum of all elements in array X 

transpose of array X; i.e., rows and columns are interchanged 



NOTE: 



Because of the finite accuracy of any computer, rounding occurs with 
operations with fractional values (v-variables) , giving results which 
may be off by only one or two bits but which can lead to serious errors* 
The tolerances indicated with certain functions and logical operations 
are designed to avoid such problems by ignoring these least significant 
bitSo However, there is no general solution to this inherent problem, 
and users must design checks for specific applications* 



Some special numerical values: 

1/0 = o3777 0000 0000 0000 0000 

-1/0 = o4000 7777 7777 7777 7777 

0/0 « ol777 0000 0000 0000 0000 

.0/0 « o6000 7777 7777 7777 7777 
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Random numbers 



seed specifies a seed for generation of random numbers with -randu- and 

-randp-; remains in effect until execution of another -seed- command 

seed VAR CONTAINING THE SEED VALUE 

seed (B) (clears former value; specifies normal system seed) 



randu selects a random number, sampled with replacement, and places it 
in the specified variable 

randu VAR, MAXIMUM (selects integer from 1 to MAXIMUM; 

0 ^ MAXIMUM < 2^6) 
randu VAR (selects a number from (3 to 1; if the tag is an 
n-variable, a value 0 or 1 is returned) 



NOTE: The next four commands are generally used together to provide 
random numbers without replacement. 



setperm single-argument -setperm- sets up two lists of Integers from 1 to 

the specified value for sampling without replacement, one a working 
copy of the list (affected by -randp-) and the other an inactive 
but alterable copy of the list (affected by -remove- and -restore-); 
two-argument -setperm- sets up one list only; a separate copy of the 
list should be maintained for use with -remove- and -restore- 

setperm MAXIMUM INTEGER IN LIST (0 ^ MAXIMUM < 120) 

setperm LIST LENGTH, STARTING VAR OF LIST (for list length > 120 and 
for special purpose sampling; first variable of the list 
contains the number of elements remaining in the list and 
each succeeding variable contains 60 elements in the list; 
number of variables required is: 2+lnt [ (length-1 ) /60] ; length 
of the list is from (? to 3000) 



randp selects a random integer without replacement from the working copy of 
the list set up by -setperm- and places it in the specified variable 

randp VAR (with 1-argument -setperm-) 

randp VAR FOR STORING VALUE, STAPTING VAR OF LIST 

(with 2-argument -setperm- or calculated list) 

Note: With either form of -randp- the value returned is 0 if the 
working copy of the list is exhausted* 



24 



C9 



remove 



restore 



removes the specified value from the Inactive copy of the list 
set up by single-argument -setperm- or from the copy of the list 
for two-argument -remove- 

remove INTEGER TO BE REMOVED . („ith 1-argument -setperm-) 
remove INTEGER TO BE REMOVED, STARTING VAR OF COPY OF LIST 
(with 2-argument -setperm-) 

uo'w'sln'?' ^P^^i^^^^ ^-1- to the inactive copy of the list set 
up by single-argument -setperm- or to the copy of the list for 
two-argument -restore- 

restore INTEGER BE RESTORED (with 1-argument -setperm-) 
restore INTEGER TO BE RESTORED, STARTING VAR OF COPY OF L^ST 
(vlth 2-arguraent -setperm-) 



modperm (no tag) replaces the working copy of the list with the current copy 

- e Lre-^\"lr%d ::th"sJ''r^ '^"^ °" -remote- a'nd 

restore , paired with single-argument -setperm- only; to simulate 

-modperm- with two-argument -setperm- use -block- or ^transfr- to 
replace the working list with the copy of the list 
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Information 
clock 



puts a character string in the «P-if^^^XJ:^L\^nd^"'(seralso^ 
24-hour clock in the tormat (space)hour. minute. secona 

the system variable "clock") 

VAR WHERE STRING IS STORED (use -showa- to display) 



clock 



date 



date VAR WHERE STRING IS STORED (use -showa- to display) 



, 1 second) 

day VAR WHERE VALUE IS STORED (use a v-variable) 



name 



group 



compute 



^hP user (up to 18 characters) left- 
fu^ri^ild^f ro\=cutirvrrrahL^s starting at the specified 
Variable with octal zero fill in unused positions 
„ame STARTING VAR (requires two consecutive variables) 

^hP user lef t-juscif ied in the specified 
places the signon group of 'he user le j positions 
variable, up to 8 characters with octal zero 

group VAR 

,4:4 A .harprter string into machine code, executes 
compiles the specified character string variable; the end 

the code, and stores the result ^^^^if i^d number of 

of the character string is determined by the ^pecit ^^^^^^^ 

characters, by six bits equal to J "^^^J.^g ^ pointer to the 

whichever is attained ^i^^'/^^^.f "^^Ve code is to be executed more 
compiled code and is required only if the code 



than once 



compute VAR FOR STORING RESBLI.SIRIKG NUM CHARACTERS I» STRING, 
compuc. POINTER TO COMPILED CODE (opt) 

"'"(I^vaUd expression does no. =o.pU., one. co.p ed. 
no reoompllatlon Is done unless pointer Is zeroed) 

STRING .s. .e ^^l;"^"^-^'/^- tr"r s:rrSrvfri:^u"o. s 
single quotes (<1<3 characters; string may contain 

''Vmli^^l\llt =r"strd»t"S;ne^s:t=ls rl^ulLd If 
;L str?Sg IS to be%reated during execution o£ the progra.. 



Note: 
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Bit and character manipulation 

search scans a character buffer for a specified object character string 

search ARGl, ARG2, ARG3,ARG4,ARG5, ARG6 

ARGl = object string (left-justified) 
ARG2 = number of characters in string (<10 characters) 
ARG3 = starting variable of buffer to be searched 
ARG4 = total number of characters in buffer 
ARG5 = relative character position at which to start search 
ARG6 = variable for storing relative character position of 
first occurrence of object string 

search ARGl, ARG2, ARG3, ARG4, ARG5,ARG6, ARG7 

ARGl = object string (left-justified) 
ARG2 = number of characters in string (<10 characters) 
ARG3 = starting variable of buffer to be searched 
ARG4 = total number of characters in buffer 
ARG5 = relative character position at which to start search 
ARG6 = variable for storing total found count 
ARG7 = number of variables following ARG6 for storing 
relative character positions of object string 

Note: In both versions of -search- the relative found location is 
-1 if the object string is not found* In the second version 
the count is 0 if the string is not found. Relative position 
of the first character is 1, of the second character, 2, etc. 
If ARG4 (length of buffer) is negative, a backwards search 
is done. 



pack packs a character string starting in the specified variable; the string 
will be left-justified xd.th octal zero fill in unused positions; if the 
character count is not desired, the field is left blank 

pack STARTING VAR FOR STORING STRINgJvAR FOR STORING 

CHARACTER COUNT ^STRING 
pack STARTING VAR FOR STORING STRINGJ JsTRING 

Note: Use n-variable(s) for packing the string if subsequent 

comparison for equality with another string is done- (If the 
character string is packed for other purposes, v-variables 
are acceptable.) Segmented variables cannot be used. 
Embedded -show- (and related embeds) may be included in the 
string. Up to 500 characters (including embedded -show-) may 
be packed, but the tag is limited to one line of code. 
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packc packs one of several character strings into a variable, depending 
on the rounded value of a conditional expression; the string will 
be left-justified with octal zero fill in unused positions; 
if the character count is not desired, the field may be left blank; 
blank argument for the character string leaves the variable (s) 
unchanged for that value of the conditional expression 

packc EXPR^STARTING VAR FOR STORING STRINgJvAR FOR STORING 
CHARACTER COTOT^STRINGM^STRING^JSTRINGlJ JsTRING3. 

Note: Up to 100 character strings may be listed. (See -pack- for 
other options and restrictions*) 



move moves character (s) from a specified charac* ' position in a 

character string to a specified position i another character string 

move FROM STARTING VAR, FROM STARTING POSITION, TO STARTING 
VAR, TO STARTING POSITION, NUM CHARACTERS (opt) 

move 'STRING' ,FROM STARTING POSITION, TO STARTING VAR, TO 
STARTING POSITION, NUM CHARACTERS (opt) 

Note: If not specified, number of characters is 1. Maximum 
number of characters is 5000. Positions may be >10. 



itoa converts an integer to a character string, left-justified with 
octal zero fill in unused positions 

itoa NUMBER, STARTING VAR FOR STORING STRING, VAR FOR STORING 
NUM CHARACTERS (opt) 

Note: Non-integer values are rounded to the nearest integer before 
conversion to a character string. 

otoa converts a number from octal format to alphanumeric format (i.e., 
to a character string) for the number of octal digits, if given 
(digits are counted from the right end of the number) 

otoa NUMBER, STARTING VAR '^OR STORING STRING, NUM DIGITS (opt) 

Note: Number of digits, if omitted, is 20* 

If number of digits <10, 1 variable is used for storing the 
string; otherwise 2 variables are used. 

similar to -otoa- but for hexadecimal to alphanumeric conversion 

htoa NUMBER, STARTING VAR FOR STORING STRING, NUM DIGITS (opt) 

Note: Number of digits, if omitted, is 15. 

If number of digits ^10, 1 variable is used for storing the 
string; otherwise 2 variables are used. 

Co 
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clean replaces the following character codes in a buffer with o55 (space): 
o?(0, 066 (subscript), o67 (superscript), o70 (shift), 

o71 (carriage return), o74 (backspace), o75 (font), o76 (access) 

clean STARTING VARIABLE, NUM VARS (opt) (NUM VARS, if omitted, is 1) 



recname takes the 18-character string specified by the first argument, 
removes characters not allowed in signon names, and returns the 
modified string in variables specified by the second argument; each 
string requires two variables; characters allowed are: lower-case 
letters, numerals, f.postrophes, accent marks, asterisks, pluses, 
minuses, and blanks (except in the first and last position and in 
contiguous positions); end of the string is marked by o{J0 

recname STARTING VAR OF STRING, STARTING VAR OF MODIFIED STRING 

Note: zreturn = -1 if the string is modified successfully 

= 0 if there are no characters in the initial string 
= +1 if there are no characters in the modified string 

Note: A legal signon name must consist of at least one symbol which 
is a letter or numeral • 
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Operations on lists 



sort arranges a list of entries stored in consecutive variables in 

ascending order according to the value of the specified sort field 

sort ARG1;ARG2,ARG3,ARG4,ARG5,ARG6 (opt) 

ARG1A;ARG2A (optional line; allows simultaneous sorting 
of an associated list of entries) 



ARGl = starting location; may be: 

STUDENT VAR (v or n) or 

CM VAR (vc or nc) or 

c,ECS COMMON LOCATION or 

s,ECS STORAGE LOCATION 
ARG2 = number of entries in list 

ARG3 = number of variables per entry (or increment between 

entries); value from 1 to 200 
ARG4 = starting bit position of sort field 
ARG5 = number of bits in sort field 
ARG6 = mask on sort field (optional) 

ARGIA = starting location (see ARGl for details) (optional) 
ARG2A = number of variables per entry (optional) 



Note: The field for numerical sorting may not extend across 
boundaries of variables. 



sorta arranges a list of entries stored- in consecutive variables in 
alphabetical order according to the internal codes for the 
characters in the specified sort field 

sorta ARGl;ARG2,ARG3jAIlG4,ARG5,ARG6 (opt) 

ARG1A;ARG.2A (optional liiie; allows simultaneous sorting 
of eAi associated list o£ entries) 

ARGl " Titarting location; may be: 

STWJENT VAR (v or n) or 

CM. VAR (vc or nc) or 

c.SCS COMt'ION LOCATION or 

p., ECS STORAGE LOCATION 
ARG2 = number of entries in list 

ARG3 = number of variables per entry (or increment between 

entries); value from I to 200 
ARG4 = starting character position of sort field 
ARG5 « number of characters in sort field 
ARG6 « mask on sort field (optional) 

ARGIA = starting location (see ARGl for details) (optional) 
ARG2A « number of variables per entry (optional) 

Note: The field for alphabetical sorting may extend across 

boundaries of variables. However, the mask can affect only 
one variable. 
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finds performs a binary chop search on a sorted numerical list 
finds ARGl,ARG2;ARG3,ARG4,/:iG5,ARG6,ARG7,ARG8 (opt) 

ARGl = starting variable containing object of search 

(the object must have the same length and relative 

position as the list entry) 
ARG2 « starting location of list; may be: 

STUDENT VAR (v or n) or 

CM VAR (vc or nc) or 

c,ECS COMMON LOCATION or 

s,ECS STORAGE LOCATION 
ARG3 = number of entries in list 

ARG4 = number of variables per entry (or Increment between 

entries); value from 1 to 500 
ARG5 = starting bit position of search field 
ARG6 « number of bits in search field 

ARG7 - variable for storing relative value of found location 
(1st entry is 1, 2nd is 2, etc); if object is not 
found, variable is set to negative of position where 
object should have been found 

ARG8 - mask on search field (optional) 



flndsa performs a binary chop search on a sorted alphabetical list 
f Indsa ARG1,ARG2;ARG3,ARG4,ARG5,ARG6,ARG7,ARG8 (opt) 

ARGl ~ starting variable containing object of search 

(the object must have the same length and relative 

position as the list entry) 
ARG2 « starting location of list; may be: 

STUDENT VAR (v or n) or 

CM VAR (vc or nc) or 

c,ECS C0M140N LOCATION or 

s,ECS STORAGE LOCATION 
ARG3 = number of entries in list 

ARG4 = number of variables per entry (or Increment between 

entries); value from 1 to 500 
ARG5 = starting character position pf search field 
ARG6 « number of characters in search field 
ARG7 = variable for storing relative value of found location 

(1st entry is 1, 2nd is 2, etc); if object is not 

found, variable is set to negative of position where 

object should have been found 
ARG8 « mask on search field (optional) 
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inserts inserts contents of specified buffer into a list of entries stored 
in consecutive variables'; shifts the remainder of the list down 

inserts ARG1,ARG2;ARG3,ARG4,ARG5, ARG6 (opt) 

ARG1A,ARG2A;ARG3A (optional line; allows simultaneous 

insertion into associated list) 

ARGl = starting variable containing object to be inserted 

(the object must have the same length as a list entry) 
ARG2 = starting location of the list; may be: 

STUDENT VAR (v or n) or^ 

CM VAR (vc or nc) o£ 

c,ECS COMMON LOCATION or 

s,ECS STORAGE LOCATION 
ARG3 = number of entries in the list 

ARG4 = number of variables per entry (or increment between 
entries); ARG4 x ARG6 = value from 1 to 500 

ARG5 = relative position in list at which to insert object 
(must be value from 1 to 1+length of list) 

ARG6 = number of entries to insert (optional; default is 1) 

ARGIA = starting variable containing object to be inserted 
(optional) 

ARG2A = starting location (see ARG2 for details) (optional) 
ARG3A = number of variables per entry (optional) 



deletes deletes the entries at the specified position in a list of entries 
stored in consecutive variables; shifts the remainder of the list 
up and fills the last entries with zeros 

deletes ARG1;ARG2,ARG3,ARG4,ARG5 (opt) 

ARG1A;ARG2A (optional line; allows simultaneous deletion 
from an associated list) 

ARGl = starting location; may be: 

STUDENT VAR (v or n) oir 

CM VAR (vc or nc) or^ 

c,ECS COMMON LOCATION ot_ 

s,ECS STORAGE LOCATION 
ARG2 = number of entries in the list 

ARG3 = number of variables per entry (or increment between 

entries); value from 1 to 500 
ARG4 = relative position in the list of the entry to be 
i deleted (must be a value from 1 to length of list) 

ARG5 = number of entries to delete (opti':nal; default is 1) 
ARGlA = starting location (see ARGl for details) (optional) 
ARG2A «= number of variables per entry (optional) 



NOTE: Commands -inserts- and -deletes- may be used on sorted or unsorted lists. 
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find scans each variable in a set of consecutive variables for the first 
variable containing the specified bit pattern 

find ARG1,ARG2,ARG3,ARG4,ARG5 (opt),AKG6 (opt) 

ARGl = object bit pattern 

ARG2 = starting variable in list 

ARG3 - number of variables in list 

ARG4 « variable for storing relative found location 

ARG5 = increment between variables (optional) 

ARG6 « mask (optional) 

findall scans each variable in a set of consecutive variables for all 
variables containing the specified bit pattern 

findall ARGl, ARG2,ARG3,ARG45 ARG5,ARG6 (opt),ARG7 (opt) 

ARGl = object bit pattern 

ARG2 « starting variable in list 

ARG3 « number of variables in list 

ARG4 « variable for storing total found count 

ARG5 « number of following variables for storing relative 

found locations (may be less than total count) 
ARG6 « increment between variables (optional) 
ARG7 = mask (optional) 

NOTE: Use n-variables with -find- and -findall-. Segmented variables may 
not be used. Increment, if omitted, is 1. Negative increment 
causes a backward scan from the last variable in the list. 
If the mask is omitted, the entire variable is compared with the 
object bit pattern. If a mask is used, the increment must be given, 
even if it is 1. 

Relative position of the first variable is 0, of the second variable, 
1, etc* 

With -find-, if the bit pattern is not found, the found location is -1 
With -findall-, if the bit pattern is not found, the count is 0 and 
the first following variable is -1. 
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Data manipulation 

block copies a set of consecutive student variables (v, n) or central 

memory variables (vc, nc) Into another set of consecutive variables 

block FROM STARTING VAR,TO STARTING VAR,NUM VARS 

transfr transfers data between v- and n-varlables (student variables), 
vc- and nc-varlables (central memory variables), ECS common, 
ECS storage, or vr- and nr-varlables (router variables) (-comload- 
and/or -stoload- must be in effect with central memory variables) 

transfr FROM STARTING LOCATION;TO STARTING LOCATION ;NUM VARS 
(general form) 

Any of the following may be used in the first two arguments of the tag 
STUDENT VAR (v or n) 

commonjECS COMMON LOCATION or c,ECS COMMON LOCATION 
storage, ECS STORAGE LOCATION or s,ECS STORAGE LOCATION 
CM VAR (vc or nc) 

router, ECS ROUTER COMMON LOCATION (when placed in "from" 

position, router lesson must contain -allow read-; 

when placed in "to" position, router lesson must contain 

-allow write-) 
routvars,ECS ROUTER VAR LOCATION (may be placed only in 

"from" position; router lesson must contain 

-allow read rvars-) 
ROUTER VAR (legal only when -transfr- command is in the 
router lesson) 

for example: 

transfr vl;c,23;10 (transfers variables vl through vl0 to ECS 

common locations 23 through 32) 

transfr v6;vc51;9 (transfers variables v6 through vl4 to 

variables vc51 through vc59) 

transfr s, ll;c, 100;21 (transfers ECS storage locations 11 through 

31 to ECS common locations 100 through 120) 

Note: Limit to length (NUM VARS) which may be transferred is set by: 
tag of -common- or -storage- (when referencing ECS) or^ 
length of -comload- or -stoload- (when referencing CM 

variables) _or 
150 (when referencing student variables) or 
tag of -routvar- (when referencing router variables) 

NOTE: For this type of operation » -block- and -transfr- are very fast* 
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common (non-executable) sets up storage space which is accessible zo all 

students in a lesson; in central memory the variables are referenced 
by vc and nc; common codewords must match when the common blocks are 
in a different lesson from the -common- command 

common LENGTH OF TEMPORARY COMMON, OPTIONS (opt) 

common , COMMON NAME, LENGTH OF PERMANENT COMMON, OPTIONS (opt) 

(-common- and common blocks are in the same lesson) 
common LESSON NAldE, COMMON NAME, LENGTH OF PERMANENT COMMON, 
OPTIONS (opt) 

(LESSON NAME is the lesson containing the common blocks) 

Note: Maximum length is 8000 words. For length < 1500, loading 
and unloading are automatic unless altered by -comload- 
or optional arguments "no load" or "read only". 
For length > 1500, -comload- must be used for access to 
central memory variables. Either or both of the following 
OPTIONS may be added to the tag of -common-: 

no load (cancels automatic loading of common from ECS to CM) 
read only (prevents transfer of common from CM to ECS) 

The following OPTION may be used only with permanent common: 

checkpt (causes common to be returned to disk approximately 
every 8 minutes) 



comload provides automatic loading and unloading of common between central 
memory and ECS during each time slice; required if common length 
exceeds 1500 and central memory variables must be accessed 

comload STARTING CM VAR (vc or nc),ECS COMMON LOCATION, NUM VARS 

(maximum of 1500 variables) 
comload (B) (unloads' CM variables and turns off further automatic 
loading until another -comload- command is executed) 

for example: 

comload vc22,10,8 (transfers vc22 through vc29 from and to 

ECS locations 10 through 17) 



comret (no tag) returns to disk the common specified by the lesson 

Note: zreturn = -1 if common is successfully returned 

= 0 if no common is specified for this lesson 

= +1 if common cannot be returned 



abort prevents return of information to disk 



abort common 

abort record (with student record; sets "user" to 'sabort' ) 

abort autocheck (with student record; sets "user" to 'snockpt' ) 

abort leslist 
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commonx similar to -ccmmon- except that -commonx- is executable; if the 

-coramonx- command and common blocks are in different lessons, the 
common codewords must match or the codeword argument must be given; 
the codeword argument must match the common codeword on the lesson 
containing the blocks; if any optional arguments are included, the 
fields for intervening missing arguments must be present 

commonx , COMMON NAME, LENGTH (opt ), 'CODEWORD' (opt ), OPTIONS (opt) 

(-commonx- and common blocks are in the same lesson) 
commonx LESSON NAME, COMMON NAME, LENGTH (opt), 'CODEWORD' (opt), 
OPTIONS (opt) 

commonx <LESLIST PO SIT ION >, COMMON NAME, LENGTH (opt ), 'CODEWORD* (opt) 
OPTIONS (opt) 

commonx (B) (disconnects current common, copies it to disk if no 

other users are in the common, and turns off comloading) 

Note: Variable^ arguments must be enclosed in parentheses. Quote 
marks on the codeword are omitted for variable argument. 
If LENGTH is omitted and common is in ECS, the ECS length is 
used; if common is not in ECS, entire common is read from disk. 
OPTIONS are the same as for -common-. 



zreturn = 



-1 
0 
1 

2 
3 



= 4 



if execution is successful 

if the common is not found or no common is in use 

if no codewords match 

if the lesson already has a common 

if the ECS version of the common has a 

different length than the declared length 

if the declared length is illegal 



initial specifies a unit to be executed by the first u£?er to encounter this 
command when a lesson or common is first brought into ECS 

initial common, UNIT NAME (not executed if common is in another 
lesson which is already in ECS and in which 
-initial common- has already been executed) 

Initial lesson, UNIT NAME 



storage (non-executable) sets up storage space which serves as a temporary 
extension of student variables; in central memory the variables are 
referenced by vc and nc; they are not saved in student records and 
are zeroed during jumpout to another lesson (see -inhibit dropstor-) 

storage LENGTH OF STORAGE (maximum length of 8000) 

storage LENGTH, exactly (lesson requires the exact amount of 

storage specified) 
storage LENGTH, minimum (lesson requires the greater of the amount 
of storage specified ^r^ the amount present when the lesson 
is entered with -inhibit dropstor- in effect) 
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stoload similar to -comload- but refers to storage; required for any 
length storage to access central memory variables 

stoload STARTING CM VAR (vc or nc) ,ECS STORAGE LOCATION, NUM VARS 

(maximum of 1500 variables) 
stoload (B) (turns off automatic loading and unloading of storage) 



NOTE; When both -comload- and -stoload- are used, care must be taken that the 
addresses of central memory variables into which common has been loaded 
do not overlap with the addresses into which storage has been loaded. 



reserve sets system variable "zreturn" in order to allow a user to reserve 
the common to prevent changes by more than one user at a time 



reserve common 



Note: zreturn = -2 if the common is already reserved by this user 
= -1 if -reserve- is executed successfully by this 
user 

= station number of user who has already reserved 
the common 



release sets system variable ''zreturn" to allow the common to be released 
release common 



Note: zreturn = -2 if the common is not reserved by any user 

= -1 if -release- is executed successfully by this 
user 

= station number of user who has reserved the comr;ion 



backgnd (no tag) flags a lesson as a "background" lesson so that it may use 
large amounts of CPU time when the time is available; when CPU time 
is scarce, the lesson is handled at lower priority than non- 
background lessons 



foregnd (no tag) switches the lesson to foreground processing; normal state 
of execution 
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System variables for calculating 

Icoramon length of common (set by tag of -common- command) 

Istorag length of storage (set by tag of -storage- command) 

zbpc number of bits per character (currently 6) 

zbpw number of bits per computer word (currently 60) 

zcpw number of characters per computer word (currently 10) 

zcusers number of users signed into the current common 
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Requesting data 



dataon specifies that student data for the lesson is to be collected and 

cone ^io'n o1%'J' f ^he student records have been set to luo: 
collection of data (see also system variable "dataon") 

dataon (B) (turns on all data collection) 

dataon TAG (TAG can be ok. no. unrec no. vocab. area, output. 

help, help no. term, term no. errors, signin) 

Note: Non-blank tag will temporarily override options set in 
group records until turned off by -dataoff- with the 
appropriate tag. 

dataoff specifies termination of collection of data for that lesson 
dataoff (B) 

dataoff TAG (TAG is same as that used in a preceding -dataon-) 

Note: Non-blank tag of -dataoff- will turn off only options 
turned on by a previous -dataon- with a non-blank tag: 
-dataoff- does not override options set In group records. 
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Classifying data 



area 



specifies a section in the ^--^^-Ji tnLr^L'forliLh 
representing 5 to 15 minutes of student contact tim_ 
certain information is collected 

Note: Information collected: 

elapsed time in the area (in adnutes; accurate to -1 minute) 
number of arrows encountered 
number of "ok" judgments 

number of unanticipated "no" judgments 
number of term requests satisfied 
number of term requests not satisfied 
number of help-type requests satisfied 
number of help-type requests not satisfied 
whether the area has been completed 



area 

area 
area 



(B) (causes data for the preceding --/"J^.P^^^/.f 
the datafile; no further data Is stored until area 
with nonblank tag is executed) 

incomplete (terminates the current area and flags it 

incomplete) current area; does not 

cancelled (cancels all ^^^^ f/^^J^^^^rds in the datafile) 
initiate a new area or produce any rei.ui.u 



^ ar,^/^t- value of an expression into the datafile 
jutput puts a comment and/or value or an cai^ 



ress] 

oueputl PU«. labeled information fro. specified student variables In 
the datafile 

— ^hfriferrXEL^^^^^^^^^ vLiables) 

setdat allows alteration of system variables containing area data 

setdat SYSTEM VAR* EXPR 

■ »„te= ■■atl.e" ^-^^^-^-Lrio^'irif rcc"afe'tot "roon^ 
TlLllX s^ater-rlables (except for "aarea") can be 
set to values up to 511 • 
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Transferring data 



readset establishes a link between a datafile and the lesson which receives 
the data 

readset DATAFILE NAME, 'DATAFILE CHANGE OR INSPECT CODEWORD' (opt) 

VAR FOR STORING NUM UNUSED BLOCKS (opt) 
readset <LESLIST POSITION>, 'DATAFILE CHANGE OR INSPECT 

CODEWORD' (opt), VAR FOR STORING NUM UNUSED BLOCKS (opt) 

Note: The second argument is included if codewords on the lesson 
and datafile or do not match. Variable arguments must be 
enclosed in parentheses; if the codeword is a variable, 
quote marks are omitted. The third argument is -1 if the 
datafile is full. 



zreturn « -1 



2 
3 
4 



if the datafile exists and is not empty 

if the name specified is not a datafile 

if codewords on the lesson and datafile do not 

match 

if the datafile is empty 

±t there is no room in ECS for the buffer 

if there is a disk error 



readd transfers data from a datafile into student variables or central 

memory variables (must be preceded by -readset- naming the datafile) 

readd area, STARTING VAR, NUM VARS 

Note: Area summary data consists of the following information: 



n(x) _or nc(x) « 
n(x) and n(x+l) 
n(x+2) contains 
n(x+3) 

n(x+4) " 
n(x+5) 

n(x+6) " 
n(x+/) 

n(x+8) " 



n(x+9) 

n(x+10) 

n(x+ll) 

n(x+12) 

n(x+13) 

n(x+14) 

n(x+15) 



II 
II 
II 
II 



■1 if 
-1 if 



starting variable 

contain the user's name (up to 18 characters) 
the lesson name 
the area name 

elapsed time for the area (in milliseconds) 

number of arrows for the area 

number of "ok" judgments for the area 

number of "ok" judgments on the 1st attempt 

number of anticipated "no" judgments (matched by 

-wrong-, -wrongc-, -wrongu-, -wrongv-, -miscon-, 

-touchw-, or -judge wrong-) 

number of unanticipated "no" judgments 

number of help-type requests satisfied 

number of help-type requests not satisfied 

number of term requests satisfied 

number of term requests not satisfied 

the area was completed, «0 if not 

the area is a continuation, »=0 otherwise 



(-readd- continued on next page) 



ERLC 



0 41 



D4 



readd outputl, STARTING VAR,NUM VARS 

Note: Data from -outputl- consists of the following information: 
n(x) oT^ nc(x) « starting variable 

n(x) contains the length of -outputl- (number of variables) 
n(x+l) and n(x+2) contain the user's name (up to 18 characters) 
n(x+3) contains the lesson name 
n(x+4) " the area name 

n(:;+5) execution time of -outputl- in milliseconds 

n(x+6) -outputl- label 

n(x+7) to n(x + NUM VARS - 1) contain data in the tag of -outputl- 
readd signoff, STARTING VAR,NUM VARS 

Note: Signoff data consists of the following information: 
n(x) o£ nc(x) = starting variable 

n(x) and n(x+l) contain the user's name (up to 18 characters) 
n(x+2) contains the lesson name 

n(x+3) " elapsed time (in minutes) spent in the lesson 

during this session 

n(x+4) " total time (in minutes) to complete the lesson 

if the lesson is completed during this session or 
-1 if the lesson is not completed during this session 

n(x+5) " date of session 

n(x+6) " time of signoff 



Note: With all tags for -readd-, 

zreturn = -1 if there is more data in the datafile 
= 0 if the end of the datafile is reached 
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Signing on and off 



restart specifies unit (and lesson if given) where the student is to begin 
at the next session 

restart (B) (start at the main unit containing this command) 
restart UNIT NAME (start in this lesson at the specified unit) 
restart LESSON NAME, UNIT NAME (start in the specified lesson at 

the specified unit) 
restart <LESLIST POSITION>,UNIT NAME (start in the lesson at the 
specified leslist position, in the specified unit; 
variable unit names must be enclosed in parentheses) 
restart ((l),(0) or restart q (clears restart information; 

no restart is in effect) 



finish specifies the unit which will be executed upon exit from the lesson 
via STOPl (but not via -end lesson- or -jumpout-) 

finish UNIT NAME 

finish (B) or finish q (clears -finish- setting), 
finish EXPR,NAMEM,NAME0,q,NAME2,x (example of conditional form; 
maximum of 100 arguments in the conditional tag) 



permit specifies whether -restart- commands (except those restarting to a 
specific unit in another lesson) are obeyed for students in groups 
with short records; has no effect for students with regular records 

permit short recs (permits -restart- commands except to a specific 

unit in another lesson) 
permit (B) (permits only -restart- commands which do not specify 
a unit; default condition) 



D6 

System variables for data keeping 
collecting data 



dataon = -1 if data collection is turned on 
= 0 if data collection is off- 
(see also command -dataon-) 



session data 



EKLC 



zsesset elapsed time since the beginning of this session (in seconds, to the 
nearest millisecond) 



zsesspt processing time during this session (in seconds, to the nearest 
millisecond) 



zsessda number of disk accesses since sign-on during this session 
area data 

aarea name of current area (left-justified; display with -showa-) 

aarrows number of arrows encountered 

ahelp number of help-type requests satisfied 

ahelpn number of help-type requests not satisfied 

aok number of "ok" judgments 

ackist number of "ok" judgments on the first attempt 

asno number of specified (anticipated) "no" judgments; also referred to 
as "wrong" judgments, where "judged" has been set to 0 

aterm number of term requests satisfied 

atermn number of term requests not satisfied 
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atitne elapsed time In the area (in milliseconds) 

auno number of unanticipated "no" judgments; "judged" has been set to +1 



NOTE: The system variables containing area data are zeroed at the beginning 
of each area. 

"atime" may have a value up to about 9 hours* 

The remaining variables (except "aarea") may have values up to 511. 
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FILE OPERATIONS 
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Attaching files 



attach establishes connection with a file and permits access to disk records 
or blocks for dataset, nameset, group, TUTOR (lesson), or code files; 
with datasets -and namesets record size may be from 64 to 512 words 

attach NAME (for read and write access) 

attach <LESLIST POSITION> 

attach NAME,rw, 'CODEWORD' (opt) (for read and write access) 

attach <LESLIST POSTION>,rw, 'CODEWORD' (opt) 

attach NAME,ro, 'CODEWORD' (opt) (for read-only access) 

attach <LESLIST POSITION>,ro, 'CODEWORD' (opt) 

Note: Codeword checks between lesson and file: 

Codeword argument omitted, read and write access: 
attach codeword on lesson must match change codeword (TUTOR file, 
code file) ^ write records codeword (nameset, dataset, 
group file); 

processor lesson — read/write ot^ special write or dual access 
(user's editing codeword [or group or account] must match 
the codeword for writing into the file) 
Codeword argument omitted, read-only access: 

attach codeword on lesson must match change or inspect codeword 
(TUTOR file, code file) ojc^ write records or read records 
codeword (nameset, dataset, group file); 

processor lesson — read only, read/write, or dual access ^r. 
special read or special write (user's editing codeword [or 
group or account] must match codeword for reading the file) 
Codeword argument included: both read/write and read only: 
CODEWORD (typable) must make same match as attach codeword- 

Variable first or third argument must be enclosed in 
parentheses; quote marks on variable third argument are omitted, 
"rw" may be replaced by an expression with value -1. 
"ro" may be replaced by an expression with value 0. 
TUTOR files and code files are always "read only". When 
the file is attached with "rw", it cannot be edited by the 
system editor or attached with "rw" access at another station. 



zreturn = -1 if connection to the file is successful 

« 0 if the file does not exist or is the wrong type 
= 1 if no codewords match 

« 2 if a user at another station is editing the file 
directory or has attached a TUTOR file or code 
file with "rw" access (or is editing the file) 

« 3 if there is an error in the directory of the file 

= 4 if a disk error has occurred 



detach disconnects a file from the lesson 



detach NAME (detaches and releases the sp;^cified file, whether 

active or inactive) 
detach <LESLIST POSITION> 
Q detach (B) (detaches and releases the current actiye file) 
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Datasets and namesets 



NOTE: When -datain-, -dataout-, -reserve-, -release- are used with namesets, 
the record designations are relative to the selected named records • 



datain 



transfers data from disk to the desired buffer 



datain STARTING RECORD NUMBER ;T0 STARTING LOCAriON;NUM 
RECORDS (opt) 



dataout transfers data from a buffer to disk 



dataout STARTING RECORD NUMBER ;FROM STARTING LOCATION ;NUM 
RECORDS (opt) 



NOTE: With -datain- and -dataout- the second argument in the tag may be: 
STUDENT VAR or c,ECS COMMON LOCATION or s,ECS STORAGE LOCATION 
The number of records transferred cannot exceed the capacity of the 
buffer. If omitted, the number of records transferred Is 1. 

zreturn = -1 if -datain- or -dataout- is executed successfully 



= 0 if there is a pack error or if the disk containing .the 
file is not available 
^ = 1 if the file has the wrong type, if no file is attached, 
or if no name has been selected 
~ 2 if record numbers extend out of range 
= 3 if the required buffer locations extend out of range 
= 4 (-dataout- only) if the user does not have write access 
« 5 (-dataout- only) if record (s) is reserved by another user 
> 6 if there is a disk error 



reserve reserves file records or the directory to prevent changes by more 



than one user at a time 

reserve records, STARTING RECORD NUMBER, NUM RECORDS 

reserve name (reserves all records in the currently selected name) 
reserve file (reserves all records in the attached file) 
reserve directory (reserves the file directory) 

Note: zreturn = -2 if the records are already reserved by this user 



« -1 if -reserve- is executed successfully by this 
user 

= 0 if no file is attached or if no name has been 
selected 

=s 1 . if record numbers extend out of range 
« 2 if the user does not have write access 
= 5+n, where n=station number of the user who has 
reserved these records 
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release releases file records or the directory 

release records, STARTING RECORD NUMBER, NUM RECORDS 
release name (releases records in the currently selected name) 
release file (releases all records in the attached file) 
release directory (releases the file directory) 



Note: zreturn = -2 if the records are not reserved by any user 

« -1 if -release- is executed successfully by this 
user 

= 0 if no file is attached or if no name has been 
selected 

= 1 if record numbers extend out of range 
= 5+Ti, where n=station number of the user who has 
reserved these records 



NOTE: With the following commands (-setname-, -getname-, -addname-, -rename-, 
-addrecs-, -delrecs-, -delname-, -names-), the name can be up to 30 
characters long (3 variables). The optional extra information for the 
name is stored in the right-most 24 bits of the specified variable. 

setname selects a name (i.e., named set of records) in a nameset 

setname 'NAME' (NAME can contain up to 10 characters; if the name 

length in the nameset is more than 10 characters, the tag 
literal is filled out on the right with zeros) 

setname STARTING VAR CONTAINING NAME 

setname nextname (selects the next name in alphabetical order or 
the first name if a name has not already been selected) 

setname backname (selects the preceding name in alphabetical order 
or the last name if a name has not already been selected) 

setname (B) (clears the name currently selected) 



Note: zreturn = -I if the specified name matches exactly a name 

in the nameset 
«= 0 if the specified name matches one name for the 

given number of characters; selects that name 
= 1 if the specified name matches more than one 

name for the given number of characters; 

selects the first of the names 
= 2 if the specified name does not match any name; 

the name reference is cleared 
= 3 if no nameset is attached 

(With tags "nextname" and "backname", "zreturn" can have only 
values -1, 2, or 3.) 
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getname stores the name currently selected and its associated extra 

information, if specified; the name is left-justified and unused 
character positions are filled with octal zeros; the extra information 
is stored in the right-most 24 bits of the specified variable and 
remaining bits are cleared 

getname STARTING VAR FOR STORING NAME,VAR FOR STORING EXTRA 
INFORMATION (opt) 

Note: If no name has been selected, a value of 0 is stored for both 
the name and the extra information* 



addname adds a new named set of records to a nameset file; selects that name 

addname STARTING VAR CONTAINING NAME,NUM RECORDS (opt), VAR 
CONTAINING EXTRA INFORMATION (opt) 

Note: Number of records, if omitted, is 1. 

Extra information, if omitted, is 0. 

zreturn = -1 if the name is added successfully 

= 0 if no nameset is attached 

= 1 if the user does not have write access 

« 2 if the new name duplicates an existing name or 

has an illegal format 

« 3 if enough room is not available for new records 

= 4 if the nameset is reserved 



rename changes the name of the currently selected named set of records 
and/or the associated extra information 

rename STARTING VAR CONTAINING NEW NAME, VAR CONTAINING NEW 
INFORMATION (opt) 

Note: If the second argument is omitted, information is unchanged. 

zreturn = -1 if the name is changed successfully 

« 0 if no nameset is attached 

« 1 if the user does not have write access 

= 2 if no name has been selected 

= 3 if the new name duplicates an existing name or 

has an illegal format 

» 4 if records in the selected name are reserved 
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addrecs adds records to the selected name 
addrecs NUM RECORDS TO ADD AT END 

addrecs RECORD POSITION, NUM RECORDS TO ADD AT THAT POSITION 

Note: zreturn = -1 if records are added successfully 
= 0 if no nameset is attached 
= 1 if the user does not have write access 
« 2 if no name has been selected 
= 3 if the specified starting position is outside 

the range of records in the named records 

(2-argument form) 
= 4 if records in the selected name are reserved 
« 5 if enough room is not available for new records 



delrecs deletes records from the selected name (but does not zero the records) 



delrecs NUM RECORDS TO DELETE FROM END 

delrecs STARTING RECORD POSITION, NUM RECORDS TO DELETE 



Note: zreturn » 



-1 
0 

1 
2 
3 



- 4 



if records are deleted successfully 

if no nameset is attached 

if the user doeSxnot have write access 

if no name has been selected 

if the specified starting position is outside 

the range of records in the named records 

(2-argument form) 

if the specified records are reserved 



delname (no tag) deletes the currently selected name and all its records 
(but does not zero the deleted records) 



Note: zreturn = -1 

= 1 

= 2 
= 4 



if the name and records are deleted successfully 

if no nameset is attached 

if the user does not have write access 

if no name has been selected 

if the specified records are reserved 
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names stores names from the nameset list (names are stored left-justified 
with octal zeros in unused character positions); each name entry, 
which may require from 1 to 3 variables, is followed by a variable 
whose left-most 15 bits contain the number of records with the name 
and whose right-most 24 bits contain the extra information 

names ARGl (opt ) , ARG2,ARG3, ARG4 

ARGl = starting position in list of nameset names (optional) 
(if omitted, starting position is the name currently 
selected by -setname- or at the beginning of the list 
if no name is selected) 

ARG2 = starting variable for storing names 

ARG3 = maximum number of variables for storing names (each 
requires from 2 to 4 variables) 

ARG4 = variable for storing actual number of names obtained 

Note: zreturn = -1 if names are stored successfully 
= 0 if no nameset is attached 
= +1 if the starting position is Invalid 
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Group files 



The following commands for namesets may also be used with group files: 
-setname-, -getname-, -names-, -addrecs-^ -delrecs-, -reserve-, -release-, 
-datain-, and -dataout-. 

The -records- command provides information on a group file» 

NOTE: With -records- command, change access changes the parameter t£ the 

information contained in the specified variable(s); read access stores 
the parameter in the specified variable(s). 

To change alphabetic information use a left-justified string (^10 
characters) or n-type variable(s) containing a left-justified string. 
To read (store) alphabetic information use n-type variables. 
(Alphabetic information is stored left-justified.) 

records change and records read allow parameters for the previously 

selected name to be changed or read 



records change ;0PTI0N1 ;0PTI0N2;0PTI0N3. . . 
records read;OFriONl ;OFnON2;OPTION3» . . 



OPTIONS: 

name, STARTING VAR (name of the record; requires 2 variables) 
user type, VAR (read only; stores user type, e.g., 'student') 

off , VAR (VAR is -1 for record turned off, 0 otherwise) 
info, VAR (the 24 bits of extra information) 

options, 'TYPE' ,VAR (author and instructor options; VAR is -1 for 
option turned on, 0 for option turned off; 'TYPE' may be 
'ifilecat' , 'anyless' , 'sitelist' , 'userlist' , 'notes' , 
'accounts' , 'dataf ile' , 'prints' , 'editown' , 'editothr' ) 

svars, STARTING ADDRESS, STARTING VAR,NUM VARS (student variables) 

rvars, STARTING ADDRESS, STARTING VAR,NUM VARS (router variables) 

message, STARTING VAR (requires 31 variables) 

lesson, VAR (name of the restart lesson; change: lesson entry may 

be a leslist position, e.g., change ; lesson , <LESLIST POSITION>) 
unit, VAR (name of the restart unit) 

score, VAR (last value of "Iscore") 

completed, VAR (last value of "Idone") 
status, VAR (last value of "Istatus") 

Idonelist, STARTING LESSON POSITION, STARTING VAR,NUM VARS (read only; 

"Idone" information, in 3-bit signed segments; "mrouter" only) 
Iscorelist, STARTING LESSON POSITION, STARTING VAR,NUM VARS (read only 

"Iscore" information, in 8-bit signed segments; "mrouter" only) 
data on, VAR (VAR is -1 for individual data collection on, 0 for off) 



(-records change- and -records read- continued on next page) 
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data opts, 'TYPE' ,VAR (individual data collection options; VAR is -1 
for option turned on, 0 for option turned off; 'TYPE' may be 
'area' , 'outpUt' , 'ok' , 'no' , 'unrec no' , 'vocab' , 'help' , 
'help no' , 'term' , 'term no' , 'errors' , 'signin' ) 

password, TYPE, VAR (opt) (change: TYPE=-1, set password to string 
in VAR; TYPE=0, zero password; TYPE=1, set password to none; 
read: TYPE is a variable which stores the value for type of 
password [-1, typable password; 0, blank; 1, none required]) 



total time, VAR 
total days, VAR 
sessions, VAR 
cpu time, VAR 
disk count, VAR 
creation , VAR 
last date, VAR 
last time, VAR 
station, VAR 
id, VAR 



(read only; total hours on PLATO; use v-variable) 
(read only; total days on PLATO) 
(read only; total sessions on PLATO) 
(read only; total cpu time in milliseconds) 
(read only; total disk accesses) 
(read only; date of creation of the name) 
(read only; date the name was last signed on) 
(read only; time the name was last signed on) 
(read only; station number where name was last signed on) 
(read only; stores "zid" information) 



Note: See 



"zreturn" 



on next page. 



records add and records delete permit names to be added or deleted 

records add ;name, STARTING VAR;user type, 'USERTYPE' ;0PTI0N1;0PTI0N2. . . 
records delete (deletes the selected name and its records; zeros 

records with basic signon data but not extra records) 

OPTIONS are those for previously selected name. 
With -records add- "name" and "user type" are required; other 
options are allowed for initializing values. If no options are 
specified, the parameters are created with value of zero. 
'USERTYPE' may be 'student' , 'multiple' , 'instructor' , or 'data' . 
(Type 'author' may be created in author group files which do not 
contain University of Illinois authors.) 

A 'data' user type may be used for storing data for the group as a 
whole. A name with this user type cannot sign onto the system. 

Note: See "zreturn" on next page. 



records changedir and records readdir allow information in the group 

directory to be changed or read 

recor^ changedir ;0PTI0N1;0PTI0N2;0PTI0N3. . . 
records readdir ;0PTI0N1;0PTI0N2;0PTI0N3. . . 

OPTIONS: 

name, VAR (read only; name of last editor) 

group, VAR (read only; group of last editor) 

(-records changedir- and -records readdir- continued on next page) 
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station, VAR (read only; station where last editor worked) 

lesson, VAR (read only; lesson which last edited the group) 

date, VAR (read only; date the group was last edited) 

time, VAR (read only; time the group was last edited) 

short, VAR (read only; VAR is -1 if the group has short records, 

0 if the group has regular-length records) 
snotes,VAR (read only; name of student notes file) 

data file, VAR (read only; name of datafile) 
processor , VAR (read only; name of processor lesson) 

router, VAR (name of student router; may not be set to a system lesson; 

change: lesson entry may be a leslist position, e.g., 

changedir;router,<LESLIST POSITION>) 
irouter,VAR (name of instructor router; change: if VAR=5(, router is 

set to ''imode''; may not be set to any other system lesson; 

change: lesson entry may be a leslist position, e-g-, 

changedir;irouter,<LESLIST POSITION>) 
group data, 'TYPE' , VAR (group data collection options; VAR is -1 for 

option turned on, 0 for option turned off; 'TYPE' is same as 

for individual data opts) 
less data, 'TYPE' ,VAR (lesson data collection options; VAR is -1 for 

option turned on, 0 for option turned off; 'TYPE' is same as 

for individual data opts) 
write code, TYPE, VAR (opt) (write records codeword; change: TYPE=-1, 

set codeword to string in VAR; TYPE=1, set to unmatchable 

codeword; TYPE=2, set codeword to user's group; TYPE=3, set 

codeword to user's account ; 

read: TYPE is a variable which stores the value for type of 
codeword [-1, typable code; 1, unmatchable; 2, group; 3, accouiit]) 
read code, TYPE, VAR (opt) (read records codeword; TYPE is same as for 
write code) 

message, 'TYPE' , STARTING VAR, VAR FOR DATETIME (opt) (message requires 
31 variables; 'TYPE' 'all' , 'student', 'multiple', 'instructor', 
or 'author' ; for read-only access, date and time the message 
was written may be returned in the optional argument as a 
character string in the form: yrmndyhrmt where yr is the 
last 2 digits of the year; mn is month number;' dy is the day 
of the month; hr is the hour; mt is the minute) 

NOTE: For all preceding forms of the -records- command: 

zreturn = -1 if -records- is executed successfully 

= 0 if no group is attached or if no name has been selected 

= 1 if the user does not have write access 

= 2 if the new name duplicates an existing name 

= 3 if there is not enough disk space available 

= 4 if the entire group or the name is reserved by another user 

= 5 if there is a disk error 

> 6 if there is an error in the (n-5)^h qPTION in the 
-records- tag, where n is the "zreturn" value 
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records locate stores the station numbers where names in the group are 
signed on; the search stops wlien the first name is found 



records locate, STATION NUMBER TO START SEARCH (opt);VAR 

(if STATION NUMBER is omitted, search starts at station 0; 
VAR is set to the station number where the first name is 
found or to -1 if no names in the group are signed on at 
stations > STATION NUMBER) 



Note: zreturn = -1 if -records locate- is executed successfully 

= 0 if no group is attached 

= 2 if the station number is invalid 

= 5 if there is a system error 



records info stores information for the name signed on at the specified 
station or for the previously selected name 

records info, STATION NUMBER (opt) ;0PTI0N1;0PTI0N2;. 

(if STATION NUMBER is omitted, data is stored for the 
selected name) 



OPTIONS: 



name, STARTING VAR 
user type, VAR 
lesson, VAR 
ma in, VAR 
current y VAR 
router , VAR 
curriculum, VAR 
zxfile,VAR 
hours on, VAR 

cpu time, VAR 
disk count, VAR 
router ecs , 'TYPE' , 

lesson ecs, 'TYPE' , 

area, VAR 
station, VAR 
site, VAR 
status, VAR 
score, VAR 
completed, VAR 



(name of the record; requires 2 variables) 

(type of record, e.g., 'student') 

(name of the lesson or type of activity) 

(name of the main unit) 

(name of the current unit) 

(name of the router lesson) 

(name of the curriculum file or instructor file) 
(name of the processor lesson database) 
(number of hOi^rs signed on for this session; 
use v-variable) 

(cpu time in milliseconds for this session) 
(number of disk accesses for this session) 
VAR (router ecs charges; 'TYPE' is 'lesson' , 

'common' , 'storage' ) 
VAR (lesson ecs charges; 'TYPE' is 'lesson', 
'common' , 'storage' ) 
(name of the current area) 

(number of the station where the name is signed on) 
(name of the site at which the name is signed on) 
(current value of "Istatus") 
(current value of "Iscore") 
(current value of "Idone") 



Note: zreturn = -1 if -records info- is executed successfully 

= 0 if no group is attached or if no name has been 
selected 

= 2 if the selected name is not signed on or if no 
name in the group is signed on at the specified 
station 

= 5 if there is a system error 

^ 6 if there is an error in the (n-5)th OPTION in the 
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records send sends a message (up to 60 characters) to the station or rings 
the sound device on the terminal (if progra;iiinable) 

records send, STATION NUMBER (opt ); message, SCREEN LOCATION, STARTING VAR 

CONTAINING MESSAGE, NIB4 CHARACTERS IN MESSAGE 
records send, STATION NUMBER (opt ); beep 

(if STATION NUMBER is omitted, the message or signal is 
sent to the selected name) 

Note: zreturn = -1 if the message or signal is sent successfully 
= 0 if no group is attached or if no name has been 
selected 

= 1 if write access to the group is not allowed 
= 2 if the selected name is not signed on or if no 

name in the group is signed on at the specified 

station 

= 4 If the message or signal cannot be sent to the 

specified station 
= 5 if there is a system error 

records backout backs out the specified station or the previously selected 

name after erasing the screen and sending a message (sets 
"backout" to -2) 

records backout, STATION NUMBER (opt) (if STATION NUMBER is omitted, 

selected name is backed off) 

Note: ^return = -1 if the backout is successful 

= 0 if no group is attached or if no name has been 
selected 

= 1 if write access to the group is not allowed 
= 2 if the selected name is not signed on or if no 

name in the group is signed on at the specified 

station 

= 3 if the station is not backed out because of error 
= 4 if the specified station cannot be backed out 
= 5 if there is a system error 
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records update updates the disk copy of the records for this user (student 

or Instructor); the user's group must be attached with 
read/write privileges, and the user's name must be selected 
with -setname- 



Note: zreturn = -1 If updating Is successful 

= 0 If no group Is attached or If no name has been 
selected 

= 1 If write access to the group Is not allowed 
= 2 If the wrong group Is attached cr the wrong 

name has been selected 
=5 3 If checkpointing has been turned off by 

-checkpt off- or -records save- 
= 4 If the selected name Is not user type 'student' 

or 'Instructor' 
= 5 If there Is a disk error or other system error 



records save similar to -records update- except that the record Is flagged 
as "saved" and automatic checkpointing Is turned off; can be 
used only In a router lesson 

Note: zreturn = -1 If -records save- Is successful 

= 0 If no group Is attached or If no name has been 
selected 

e 1 If write access to the group Is not allowed 
= 2 If the wrong group Is attached or the wrong 

name has been selected 
» 3 If -checkpt off- Is In effect or If the record 

has already been saved 
« 4 If the selected name Is not user type 'student' 

or 'Instructor' 
= 5 If there Is a disk error or other system error 



records restore retrieves the saved record from disk; used with 

-records save-; can be used only in a router lesson 

Note: zreturn « -1 if -records restore- is successful 

" 0 if no group is attached or if no name has been 
selected 

e 1 if write access to the group is not allowed 
« 2 if the wrong group is attached or the wrong 

name has been selected 
= 3 if the record has not been saved by -records save- 
= 4 if the selected name is not user type 'student' 

or 'instructor' 
= 5 if there is a disk error or other system error 
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allows the program to control checkpointing of student and instructor 
records; a -checkpt- command executed in a router sets the default 
for checkpointing for subsequent instructional lessons 

checkpt on (allows automatic checkpointing; normal default for 
students) 

checkpt off (prevents automatic checkpointing; normal default for 
instructors) 

checkpt EXPR (value«0 sets to "off"; value«-l .sets to "on") 



Note: zreturn = -1 if -checkpt- is successful 

« 0 if -checkpt- cannot be used with this user type 
( 'multiple' , 'author' , 'sabort' , 'snockpt' ) 
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TUTOR files and code files 



setname selects a block name from the attached file; contiguous blocks with 
the same name are selected at the same time 

setname 'NAME' 

setname VAR CONTAINING NAME 

setname nextname (selects the next name in sequence or the first 

name if a name has not already been selected) 

setname backname (selects the preceding name in sequence or the 

last name if a name has not already been selected) 

setname (B) (clears the name currently selected and selects source 
blocks set to condense) 

Note: zreturn = -1 if the specified name matches exactly a block 

name in the file 
= 0 if the specified name matches one name for the 

given number of characters; selects that name 
= 1 if the specified name matches more than one 

name for the given number of characters; 

selects the first of the names 
« 2 if the specified name does hot match any name; 

the name reference is cleared 
= 3 if no TUTOR file or code file is attached 

(V7ith tags "nextname" and "backname", "zreturn" can have only 
values -1, 2, or 3.) 



getname stores the name currently selected and the associated information, 
if specified; name is left- justified and unused character positions 
are filled with octal zeros 

getname VAR FOR STORING NAME, VAR FOR STORING INFORMATION (opt) 

format for the information (counting from the left end of 
the variable): 

42 bits (7 characters): block type (left-justified) 

binary, charset, common, leslist, lineset, listing, 
micro, source, text, vocab 

6 bits (1 character): condense flag [("-" (o46) or " " (o55)] 

3 bits unused 

9 bits: block position in directory 

Note: If no name has been selected, a value of 0 is stored for both 
the name and the information. 



EKLC 



GO 



F15 



names stores names of blocks in the file (left-justified with octal zeros 
in unused character positions); each entry requires 2 variables, the 
first for the name and the second for the associated information 



names ARG 1 (opt ) , ARG 2 , ARG3 , ARG4 

ARGl « starting postion in the directory of block names 
(numbaring starts at 1 for block 1-b) 
(optional; if omitted, starting position is the name 
currently selected by -setname- or the beginning of 
the list if no name is selected) 

ARG2 « starting variable for storing names 

ARG3 « maximum number of variables for storing names (each 
requires 2 variables) 

ARG4 «= variable for storing actual number of names obtained 

format for the associated information (counting from the 
left end of the variable): 

6 bits (1 character): condense flag (o46) or " " (o55)] 

6 bits (1 character): blank (o55) 
12 bits (2 characters): block type 



It II 


(o5555) 


(source) 


"11" 


(olAlA) 


(leslist) 


"bi" 


(O0211) 


(binary) 


"In" 


(ol416) 


(lineset) 


"ch" 


(o(i(310) 


(charset) 


"mi" 


(ol511) 


(micro) 


"cm" 


(O0315) 


(common) 


"tx" 


(o2430) 


(text) 


"11" 


(oUU) 


(listing) 


"vc" 


(o26Cl3) 


(vocab ) 



27 bits unused (o(i(0(3(3(3(30(iK3) 
9 bits: number of words of disk space used 

Note: zreturn « -1 if names are stored successfully 

= 0 if no TUTOR file or code file is attached 
= +1 if the starting position is invalid 



iospecs specifies parameters for subsequent -getline- commands 
iospecs 0PTI0N1,0PTI0N2, OPTIONS 
options include: 

mods mod words are included in the lines read 

nomods mod words are not included in the lines read 

deleted deleted lines are included in the lines read 
nodeleted deleted lines are not included in the lines read 
truncate the line is truncated if it is too long for the buffer; 

the line pointer moves to the next line 
notruncate the line is truncated if it is too long for the buffer; 

the line pointer stays at the truncated line 



Note: If the -iospecs- command is omitted, the default options are: 
nomods , nodeleted , truncate 



getline reads a line from the selected block name in the attached file and 
stores it (left-justified) in the specified variables 



getline ARG1,ARG2, ARG3 



/lRGI = starting variable of the buffer for storing the line 
ARGl = number of variables in the buffer 

ARG3 = variable for storing the number of variables actually 
required to store the line 



Results depend on options set by previous -iospecs-: 



mods 

nomods 
deleted 
nodeleted 
truncate 



notruncate 



mod words are stored in the first 2 variables of the 
buffer 

mod words are not stored 
deleted lines are stored 
deleted liaes are not stored 

a line which is too long for the buffer is truncated, and 
the truncated line is stored; all lines end with 12 bits 
of 0 (00000); return length is the number of variables 
actually used to store the line 

a line which is too long for the buffer is truncated and 
stored (but the next -getline- command will attempt to 
store this line without truncation); lines so truncated 
will not end in 12 bits of 0; return length is the true 
length of the line, i.e., the number of variables that 
would be required to store it without truncation 



Note: zreturn = 



-1 if -getline- is executed nuccessfully 

0 if no TUTOR file or code file is attached 

1 if there are no lines left in the selected blocks 

2 if the line length is greater than the buffer 
length (the line is truncated) 

3 if this line is a deleted line 

4 if this line is a truncated deleted line 

5 if a system disk error has occurred 



setline sets the pointer for the line to be read by the next -getline- 
command; should be used in conjunction with "zline" 

setline VAR CONTAINING VALUE OF DESIRED "zline" 

Note: zreturn = -1 if -setline- is executed successfully 

« 0 if no TUTOR file or code file is attached 
« 4-1 if the pointer value is illegal 
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parse analyzes (or parses) a line of TUTOR code stored in a buffer 

parse ARGl, ARG2,ARG3,ARG4,ARG5, ARG6 

ARGl » starting variable containing the line of code 
ARG2 « number of variables to examine (end of line also 

terminates the search) 
ARG3 « variable for storing indent level of code 

(» 0 if not indented) 
ARG4 « variable for storing the command name, left-justified 

and filled to character position 8 with spaces (o55); 

if the line is a comment, the first 8 characters of 

the line are stored 
ARG5 « variable for storing the relative character position 

of the beginning of the tag 
ARG6 = variable for storing the number of variables actually 

required to store this line 

Note: zreturn « -1 if the line is a comment or a deleted line 
= 0 otherwise 
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System variables for file operations 

These system variables are set when the approplate file Is attached or v;hen a 
name has been selected (In the attached nameset or group file). 

zcheck current checkpointing status of records 
= -1 If checkpointing Is allowed 
= 0 If -checkpt off- Is In effect 
= 1 If -records save- is in effect 

= 2 if -abort record- or -ab^rt autocheck- is in effect 
= 3 if the user is an author or a multiple 

zfacc = -1 if the file is attached read/write 

= 0 if the file is attached read only or if no file is attached 

zfile name of the file currently attached to the lesson 
(left-justified; display with -showa-) 

zf type type of file which is attached to the lesson ( 'dataset' > 'nameset' f 
'group' , 'lesson' , 'code' ) (left-justified; display with -showa-) 

zfusers number of users connected to the file currently attached 

zinfo contains the 24 bits of information associated with the currently 

selected name in a nameset or group; stored in the right-most 24 bits 

zline value of the pointer to the next line to be read by -getline- 

znindex position of the currently selected name in the nameset or group 

directory (= 0 if no name has been selected or if no nameset or group 
is attached) 

znscpn number of characters per name for the attached file 

(« 10 for TUTOR file and code file; = 18 for group file) 

znsmaxn maximum number of names (or blocks) allowed in the attached file 

znsmaxr maximum number of records (or blocks) allowed in the attached file 

znsnams number of names in use in the attached nameset or group 
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znsrecs number of records in use in the entire attached nameset or group 



zrecs number of records in the selected name in the attached nameset or 
number of extra records (i.e., records added with -addrecs-) in the 
selected name in the attached group or 
number of records in the attached dataset 



zroff « -1 if the currently selected name in a group has been turned off 
= 0 otherwise 



zrstatn station number where the currently selected name in a group is signed 
on (= -1 if the name is not signed on) 



zrtype user type of currently selected name in the attached group J 
'student' , 'multiple' , 'instructor' , 'author' , 'data' 
(left-justified; display with -showa-) 



zrvars maximum number of router variables (currently 64) 



zrvret = -1 if router variables are permanently stored on disk 
« 0 if router variables are not permanently stored 



zsvars maximum number of student variables (currently 150) 



zsvret « -1 if student variables are permanently stored on disk 
= 0 if student variables are not permanently stored 



zwpb number of computer words per block in the attached TUTOR file or 
code file (currently 320) 



zwpr number of computer words per record in the attached file 
(= 320 for TUTOR file and code file; = 64 for group file) 



zxfile 



contains the name of the file through which a processor lesson is 
accessed (« 0 if the processor lesson is entered directly) 
(left-justified; display with -showa-) 



Additional notes on FILE OPERATIONS 
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Two types of coimnands are described In this section: judging commands 
and regular commands. (In all other sections of this book only regular 
commands are described.) Regular commands are not executed during the 
judging process, i.e., after the student has entered a response, nor are 
judging commands executed before the student has entered a response or 
in situations where no response is involved. (See "The TUTOR Language" 
and lesson "aids" for extensive descriptions of the judging process.) 

Regular commands in this section include: -eraseu-, -force-, -edit-, 
-arrow-, -arrowa-, -arheada-, -long-, -jkey-, -copy-, -endarrow-, -getword-, 
-getraark-, -getloc-, -compare-, -iarrow-, -larrowa-, -judge-, -okword-, -noword-, 
-markup-, -markupy-. Commands -list-, -endings-, -vocabs-, -vocab- are special 
non-executable commands which establish lists of words for use with certain 
response-matching commands. The -join- command is both regular and judging. 
The remaining commands in this section are judging commands • 



Preparation for responding 



eraseu (regular command) the specified unit ±3 executed at all subsequent 
arrows in the unit containing -eraseu- 'when the student erases part 
or all of a response after receiving judgment; useful for erasing 
complicated displays which are not handled by the standard judging 
process 

eraseu UNIT NAME 

eraseu (B) or^ eraseu q (clears -eraseu- setting for remainder 

of the unit) 

eraseu EXPR,NAMEM,NAME0,q,NAME2,x (example of conditional form; 
maximum of 100 arguments in the conditional tag) 



force (regular command) alters the input of a response as specified; 
setting is cleared at each main unit 

force firsterase (erases an incorrect response and contingent 
message when the student presses any key, not just 
NEXT, ERASE, etc) 
force font (inserts the font code before the first keypress) 
force left (forces the response to be written from right to left) 
force long (initiates judging when the character input reaches 

the value of the tag of -long-; unnecessary with -long 1-) 
force micro (forces all keypresses through the microtable 
conversion) 

force (B) or^ force clear (clears previous -force- settings 

in that unit) 
force clear,font ,lef t (may combine tags) 
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edit (regular command) required for EDIT key to be active when the tag 

of -long- exceeds 150; specifies the starting variable of a buffer 
for storing the characters in a response (up to 300 characters) 

edit STARTING VAR (use student variable) 

edit (B) (clears edit buffer; if placed after -arrow-, prevents 
use of the EDIT key; see also -inhibit edit-) 



arrow (regular command) plots the response arrow at the specified screen 
location (see -inhibit arrow-); sets defaults: -long 150- and 
-jkey (B)- 

arrow COARSE 
arrow FINEX,FINEY 



arrowa (regular command) allows an alternative arrow associated with -iarrowa- 
and -arheada-; follows same rules and restrictions as -arrow- 

arrowa COARSE 
arrowa FII!EX,FINEY 



arheada (regular command) specifies a symbol to be plotted with the 
alternative arrow 

arheada SYMBOL TO BE PLOTTED WITH -arrowa- 

Note: Up to five 6-bit characters may be specified. 

long (regular command) sets the maximum number of characters in a response 

(default is 150 characters); must follow -arrow- (see NOTE) 

long NUM CHARACTERS (value of tag is from 0 to 300; -long 1- 
causes automatic judging; tag > 150 requires use of 
-edit- for EDIT key to be active; -long 0- prevents 
input from the keyset except for function keys) 

jkey (regular command) specifies the function key(s) which will Initiate 

judging (in addition to the NEXT key); must follow -arrow- (see NOTE) 

jkey KEYNAME (name of function key is in lower case) 
j key KEYNAME 1 , KEYNAME 2 , KEYNAME 3 , . . . 

jkey (B) (clears previous -jkey- settings so that only NEXT 
initiates judging) 
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copy (regular command) specifies the starting variable of the character 

string vhich is to be copied on the screen at the arrow, one word at 
a time, when the COPY key is pressed; the end of the character string 
is indicated by the specified number of characters or by 12 bits equal 
to 0 (09000), whichever is attained first; loads the sting as it 
appears on the screen into the response buffer; must follow -arrow- 
(see NOTE) 

copy STARTING VAR,NUM CHARACTERS (use student variable) 

NOTE: To affect the first response, -long-, -jkey-, and -copy- must follow the 
-arrow- command but must precede any judging commands. However, after 
the student enters a response (e.g., an incorrect response), these 
commands can be executed among the regular commands following** the 
matched response in order to affect the next response at the same arrow* 



endarrow (regular command) (no tag) terminates judging with an unanticipated 
'*ao'' judgmeanz if the response has not been matched; after an "ok" 
judgment, -endarrow- terminates the search for additional -arrow- 
commands and switches back to the pre-arrow state 
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Vocabulary lists 



list (non-*executable) sets up a list of synonyms for judging; used with 

-answer-, -wrong-, -anawerc-, -wrongc-, and -match- 
list LISTNAME,W0RD1,PHRASE*C0NSISTING*0F*SEVERAL*W0RDS, 

WORD2,WORD3, . . . (maximum of 7 characters in LISTNAME) 



endings (non-^executable) used xd.th -vocabs- and -vocab- to add endings to 
root words (must precede -vocabs- or -vocab-) 

endings NUMBER,ENT)ING1,ENDING2, • • . (NUMBER is an integer from 0 to 9) 

Note: In ^vocabs- or -vocab-, 

WORD /NUMBER adds endings to the root word and includes all 

words in the vocabulary 
WORD//NUMBER adds only words with endings to the vocabulary; 
the root word is not included 
Up to 10 -endings- commands with up to 8 endings each may 
be included. Apostrophe is legal in an ending* 



vocabs (non -executable) sets up lists of ignorable words and synonymous 
required words; used with -concept- and -miscon-; checks for . 
capitalization and spelling; allows assignment of user information 
numbers 



vocabs NAME 

<IGNORABLE WORDS SEPARATED BY COMMAS > 
WORD 1 , WORD 2 , PHRAS E *GON S I ST ING *0F *S E VERAL *WORD S 
(SYNONYMOUS WORDS 3 AND PHRASES SEPARATED BY COMM^iS) 
(WORD4/s,WORD5/ENDINGl/ENDING2,WORD6//ENDINGl) 
WORD 7/NUMBER 1 , WORD 8//NUMBER2 
(W0RD9, WORD 10«1, WORD 11-2, SYNONYM 1 1=2, ... ) 



vocab (non-executable) similar to -vocabs- except does not check for 
capitalization and spelling and does not allow phrases 

vocab NAME 

<IGNORABLE WORDS SEPARATED BY COMMAS > 
WORD 1, WORD 2 

(SYNONYMOUS WORDS 3 SEPARATED BY COMMAS) 
(WORD 4 /s , WORD 5 /END ING 1 /END ING 2 , WORD 6 / /END ING 1 ) 
WORD 7 /NUMBER 1 , WORD 8 / /NUMB ER 2 
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NOTE: Up to 7 characters are permitted in the name of the vocabulary. 

When sets of endings are used repeatedly, -endings- plus -vocab (s)- 
may be more convenient than -vocab (s)- with actual endings included. 
With -vocabs-, user information numbers may have values from 1 to 511. 
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Modification of judging copy of response 



bump removes the specified characters from the judging copy of the 
response before judging 

bump CHARACTERS (maximum of 8 characters; use additional 

-bump- commands for more than 8 characters) 
♦ 

put replaces a character string in the judging copy of the response 

with another character string 

put STRING 1«STRING 2 (replaces STRINGl with STRING2) 



putd similar to -put- but uses the first character in the tag as the 
separator between strings 

putd /STRINGl /STRING2/ (separator is /) 

putd , STRINGl, STRING2, (separator is ,) 



putv similar to -put- but works with stored strings 

putv ARG1,ARG2,ARG3,ARG4 

ARGl « starting variable of string (left-justified) 
ARG2 = number of characters in string 

ARG3 « starting variable of replacement string (left- justified) 
ARG4 » number of characters in replacement string 



NOTE: Maximum number of characters in a 
Is 50» If replacement operations 
to exceed 300 characters, judging 



string for -put-, -putd-, and -putv- 
cause the judging copy of the response 
terminates with a "no" judgment. 



close takes characters stored in the right-most six bits from successive 
variables and makes a judging copy for use with judging commands; 
often paired with -open-; the end of the character string is 
indicated by the specified number of characters or by six bits 
equal to zero (o(J0), whichever is attained first 

close STARTING 7AR,NUM CHAR/VCTERS (use n-variables) 



loada takes the characters stored in the specified variable(s) by -pack-, 
-storea-, or -calc- and makes a judging copy; the end of the 
character string is Indicated by the specified number of characters 
or by six bits equal to zero (o00) , whichever is attained first 

loada STARTING VAR,NUM CHARACTERS (opt) (number of characters, 
if omitted, is 10; maximum number of characters is 299) 
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Modification of judging procedure 

NOTE: The various -specs- options do not affect J judging coramands. 

Commands affected by each -specs- option are indicated by number 
from the following list. 

judging commands affected by -specs- 

1. -match- 

£• -answer-, -wrong-, -answerc-, -^rongc- 

3« -vocabs-, -concept-, -miscon- 

4. -vocab-, -concept-, -miscon- 

5. -exact-, -exactc-, -exacty- 

6. -ansv-, -wrongv-, -ansu-, -wrongu-, -store-, -storeu- 
7« -storen- 

8. -storea- 



specs allows control over processing of responses; also serves as a marker 

for execution of subsequent regular commands after judging is complete 

specs allwords (treats integers like letters [rather than 

numbers] so tLat a number-letter boundary is not 
like a word-word boundary or punctuation) 
(with 1, 2, 3, 4, 7 above) 

specs alphxnum (treats a letter-number boundary like a 

word-word boundary or like punctuation) 
(with 1, 2, 3, 4, 7 above) 

specs bumpshift (removes shift codes from the judging copy 

of the response) 
(with all commands above) 

specs exorder (checks the order of ignorable words) 

(with 2 above) 

specs holdmark (prevents markup of student response but stores 

the markup information for later display) 
(with all commands above where markup is done: 2, 3, 4) 

specs nodiff (turns off the numeric difference judger, 

which treats a numerical response as a 
"misspelling" If it is within 10% of the 
correct response; no spelling markup is done) 
(with 2 above) 

specs nomark (turns off answer markup) 

(with all commands above where markup is done: 2, 3, 4) 
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specs nookno (prevents appearance of "ok" and "no") 

(with all commands above) 
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specs noops (prevents use of mathematical operations in a 

numerical response) 
(with 6 above) 

specs noorder (turns off the order judger; allows any 

word order; no order or keyword markup is done) 
(with 2, 3, 4 above) 

specs nospell (turns off the spelling judger; no spelling 

markup is done) 
(with 2 above) 

specs novars (prevents use of variables defined in 

define set "student") 
(with 6 above) 

specs okassign (allows assignment of a value to a variable 

defined in define set "student") 
(with 6 above) 

specs okcap (allows a capitalized word in the response to 

match a non-capitalized word in the tag of a 
response-matching command or in the vocabulary) 
(with 1, 2, 3 above) 

specs okextra (allows extra words in the response; 

caution — words not in -vocabs- may be 
treated as spelling errors) 
(with 2, 3, 4 above) 

specs okspell (allows any reasonable spelling) 
(with 1, 2, 3 above) 

specs toler (allows 1% tolerance in a numerical response) 

(with 1, 2 abave) 

specs (B) (acts only as a marker) 

specs nooknojokspell , noorder (may combine tags) 

Note: The following system variables are set properly even if 
use of the -specs- tag causes the response to match the 
tag of a response-matching command* 

-specs- tag system variable 
okspell spell 
okcap capital 
okextra extra 
noorder order 
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Storing judging copy of response 



NOTE: Commands -store-, -storeu-, and -storen- terminate judging with a 
"no" judgment if an error is found in the form of the response. 



store calculates the numerical value of the response and stores it in 
the variable specified in the tag 

store VAR 



storeu similar to -store- but also evaluates dimensionality of units 

storeu VAR FOR STORING NUMBER, STARTING VAR FOR STORING POWERS 

OF DIMENSIONS (see -define-: units; use v-vaiTiables to 
store the powers of the dimensions; powers are stored 
in the order in which the primary units are defined) 



storen searches for and evaluates simple numerical expressions (without 
variables) in the response, which may also contain non-numeric 
characters; stores numerical results in the specified variables one 
at a time; removes numerical parts of the response from the answer 
buffer and replaces thsm with blanks: numerical parts must be set off 
from letters by spaces or punctuation; if no numerical expression is 
found, the variables are set to 0 and judging ends with a "no" 
judgment; each -storen- increments "anscnt" 

storen VARl 
storen VAR2 



storea stores characters from the response, left-justified, in the specified 
variable(s), 10 characters per variable; unused character positions 
are filled with octal zeros 

storea STARTING VAR,NUM CHARACTERS (opt) (number of characters , 

if omitted, is 10) 

Note: Use n-variable(s) for storing the string if subsequent 

comparison for equality with another string is done. (If the 
character string is stored for other purposes, v-variables are 
acceptable.) Segmented variables cannot be used with -storea-. 



open places the characters in the response, one-by-one, in the right-most 
six bits of successive variables starting at the specified variable 

open STARTING VAR (use n-variables) 
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Matching judging copy of response 



NOTE: In this sub-section references to response mean judging copy of the 
response. 

NOTE: Up to 39 "words" (entries separated by space or punctuation) are 

permitted in responses with -match-, -answer-, -wrong-, -ansv^erc-, 
-wrongc-, -concept-, and -miscon-. If the number of words exceeds 39, 
judgment is "no" and "anscnt" is set to -2. 



match checks the response against the arguments in the tag and sets a 

variable to the relative -Position of the matchec? character string; 
if no match is found, the variable is set to -1 and judgment is 
"no" ("judged" set to +1); otherwise judgment is "ok" ("judged" 
set to -1); always ends judging 

for example: 

ma t ch VAR , WORD 0 , WORD 1 , FHRA S E *WORD 2 , WORD 3 

match VAR, (WORD0, SYNON1M0) , (WORDl, (LISTNAMEl ) ) , ( (LISTNAME2) ) 



answer compares the response with the tag; checks for word order, spelling, 
capitalization, extra words, and numeric tolerance unless altered 
by -specs-; sets "judged" to -1 if response matches tag 

for example: 

answer WORDS AND PHRASE*WORDS (blank tag matches a response in 
which nothing is entered or which contains only spaces 
and punctuation) 
answer <EXIRA WORDS > (SYNONYMOUS WORDS 1 AND PHRASE*W0RDS1 

SEPARATED BY COMMAS) (SYNONYMOUS WORDS 2 and PHRASE*WORDS 2 
SEPARATED BY COMMAS) WORD 3 
answer «LISTNAME1»((LISTNAME2),W0RD2) 

answer RESPONSEl;RESPONSE2;RESPONSE3 (each argument may have any 

of the preceding forms for the tag of -answer-; synonymous 
responses for the same argument are separated by commas) 

Note: Tag must r/; contain punctuation (or symbols changed to "punc" 
in the -cha.age- command), although the student's response may. 

v/rong compares the response with the tag; performs checks available with 
-answar-; sets3 "judged" to (!( if response matches tag 

wrong WORDS AND PHRASE*WORDS 

Note: Options for the tag of -wrong- are the same as for the tag 
of -answer- bMt for an incorrect f?tudent response*.. 
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answerc compares the response with one of several arguments in the tag, 
depending on the rounded value of the conditional expression; 
performs the checks available with -answer-; sets "judged" to -1 
if response matches the required argument 

answerc EXPR$RESPONSEmJrrSPONSE0 J|rESP0NSE2 (the arguments may 
have any of the forms allowed in the tag of -answer-; 
a blank argument indicates no anticipated response for 
that value of the conditional expression) 



wrongc same options as for -answerc- but for an incorrect response; sets 
"judged" to 9 if response matches the required argument 

wrongc EXPR^RESP0NSEmJ||rESP0NSE2JrESP0NSE3 

concept compares the response with the tag; -vocab- or -vocabs- provides 
synonyms; sets "judged" to -1 if response matches tag 

concept WORDS AND PHRASE WORDS (no asterisk in phrases; blank tag 
matches a response which is blank or which contains only 
ignorable words from the vocabulary) 

concept WORDl W0RD2, VAR1<^ WORDl, VAR2<^ W0RD2 (detects which synonym 
is entered if the vocabulary is appropriately set up) 



miscon same options as for -concept- but for an incorrect response; sets 
"judged" to 9 if response matches tag 

miscon WORDS AND PHRASE WORDS 



exact compares the response with the tag for an exact character string 
match; sets "judged" to -1 if response matches tag 

exact STRING (blank tag matches a response in which nothing 
is entered) 

exactc compares the response for an exact character string watch with one 
of several argum^Sts in the tag depending on the rounded value of a 
conditional expression; sets "judged" to -1 if response matches the 
required argument 

exactc EXPR,STt<.INGM,STRING0,,STRING2 (blank argument matches a 
response in which nothing is entered) 
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exactv compares the response with a stored character string for an exact 

match; the end of the character string is indicated by the specified 
number of chf.racters or by six bits equal to zero (000) , whichever 
is attained first; sets "judged" to -1 if response matches tag 

exactv STARTING VAR OF STORED STRING, NUM CHARACTERS (opt) 
(number of characters, if omitted, is 10; if the 
number of characters is 0, the response is judged 
correct if nothing is entered) 



NOTE: With the following four commando (-ansv-, -wrongv-, -ansu-, --wrongu-) 
TOLERANCE is optional. When tolerance is omicted, the default is 10"" 
if the absolute value of the tag value is less than approximately 100 
or (10"^^ X I tag value I) if the absolute value of the tag value is 
greater than approximately 100. These commands cannot judge values 
smaller in absolute value than 10"^ since any response less than 1^ 
will then match the tag. 

TOLERANCE may be absolute deviation or percent deviation. 

ansv checks a numerical response against the first argument in the tag, 
with tolerance, if given, set by the second argument; sets 
. "judged" to -1 if. response matches tag (within the tolerance) 

ansv CORRECT VALUE, TOLERANCE 



wrongv similar to -ansv- but for the incorrect numerical response; sets 
"judged" to 0 if response matches tag (within the tolerance) 

wrongv INCORRECT VALUE, TOLERANCE 

ansu similar to -ansv- but checks for correct units; sets "judged" to -1 
if response matches tag (within the tolerance) 

ansu NUMBER AND UNITS, TOLERANCE 



wiongu fiimi] >r to -ansu- but for incorrect response; sets "judged" to 0 
if response matches tag (within the tolerance) 

wrongu NUMBER AND UNITS, TOLERANCE 

wrongu NUMBER, TOLERANCE (may be used to indicate that units 

are missing) 



NOTE: For applications of -ansu- and -wrongu- see -storeu- and -v'lefine-. 

Commands -ansv- and -wrongv- accept defined units in the student's 
response but do not compare with author's units. 
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touch specifies the location of a rectangle for a touch response; sets 

"judged" to -1 if the specified rectangle is touched (see -enable- 
and -disable-) 

touch AREA1;AREA2;AREA3; . . . (blank tag matches any touch input) 

Note: AREA may be: COARSE, WIDTH IN CHARACTERS, HEIGHT IN LINES 
£r FINEX,FINEY, WIDTH IN DOTS, HEIGHT IN DOTS 
COARSE or FINEX,FINEY is the screen location of the lower 
left corner of a rectangle of specified width and height. 
Width and height are optional and assumed to be 1 if omitted. 

f.ouchw same options as -touch- but for an incorrect touch response; sets 
"judged" to 0 if the specified rectangle is touched 

t o u chw AREA 1 ; AREA 2 ; AREA 3 ; AREA 4 ; . . . 



One touch square is 32 dots on each side (or 4 characters in width 
and 2 lines in height). 

(no tag) placed on the line between response-matching commands 
to provide alternative re.?ponses for the same value of "anscnt" 

(no tag) allows use of the ANS key; terminates judging only if 
ANS is pressed; otherwise normal judging occurs; -ans- must be 
the first judging command following the -arrow- command unless 
-jkey ans- is in effect 
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Information on specific words in response 



NOTE: In the follov/lng commands (-getword-, -getmark-, -getloc-, -compare-), 
a "word" is an entry set off by spaces or punctuation from surrounding 
characters* (See -specs allwords-, -specs -alphxnuE- and 
-change symbol- for additional options in specifying word boundaries.) 



getword (regular c^^mmand) allows storage of individual words in a response 
getword ARGl, ARG2,ARG3, ARG4 (opt) 

ARGl « relative position of the word in the response 

(first word is 1, second word, 2, etc.) 
ARG2 « starting variable for storing the word (up to 

1(3 characters per variable) 
ARG3 variable for storing the actual number of characters 

In the word (=0 if ARGl>"wcount") 
ARG4 » maximum number of characters to be stored in ARG2 

(optional; if omitted, value is 10) 

Not.e: Words that are stored are not removed from the judge buffer. 



getmark (regular command) used after judging a response to give markup 
information on individual words in the response 

getmark ARG1,ARG2 

ARGl = relative position of the word in the response 

(first x^rd Is 1, seccn^i Tirord, 2, etc.) 
ARG2 = variable containing markup information 

= -2 if the response is perfect or if no markup is done 

with the response-matching command used 
= -1 il' the position of the word is out of bounds 

(i.e., if ARGl>"wcount") 
= 0 if there are no errors in the word 
> 0 bits in ARG2 are set according to the eyriOi: j), 
starting at the right-most bit (subscript "2" 
indicates the number is in binary notation): 
(I2) a word preceding this word is missing 
(1?2^ word is out of order (too far right) 
(1000^ there is a capitalization error 
(I 0002) the spelling is incorrect 
(10 0002) the word is part of a broken phrase 
(100 0002) the word is an extra word 
(1 000 0002) this word is the last word, and a 

word which should follow is missing 
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getloc (regular command) gives the screen position of the beginning (and 
end, if requested) of the specified word in the response 

' getloc ARG1,ARG2,ARG3,ARG4 (opt),ARG5 (opt) 

ARGl = relative position of the word in the response 

(first word is 1, second word, 2, etc.) 
ARG2 = variable for storing the finex screen position of 

the beginning of the word (= -1 if ARGl > "wcount") 
ARG3 = variable for storing the finey screen position of 

the beginning of the word 
ARG4 = variable for storing the fiuex screen position of 

the end of the word (optional) 
ARG5 = variable for storing the finey screen position of 

the end of the word (optional) 



compare (regular command) compares two words for spelling 

compare AUTHOR WORD, STUDENT WORD,VAR FOR STORING RESULT CODE 

result = -1 if words are different 

= 0 if words are identical 

> 0 if words are misspellings of each other 

(smaller value indicates a closer match) 

Note: The first two arguments may also be variables. The words must 
be stored in the variables in the same manner, e.g., both 
words left-justified or both right-justified. If the words are 
stored with -storea- or -pack-, they will be lef t-justif ied^ 
If a word itself is given, rather than the variable(s), it 
should be enclosed in single quotes for left-justification 
or double quotes for right-justif ication. 

System variables "spell" and "capital" are set appropriately 

if result value > 9* 

"spell" is set to 0 if result > 0; 

"capital" is set to 0 if only one word is capitalized 



so 



ERIC 



J15 



Unconditional judgment 

ok (no tag) judges any response "ok"; sets "judged" to -1 

no (no tag) judges any response "no"; sets "judged" to +1 

ignore (no tag) erases and ignores any response; stops further 
processing and waits for a new response 
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Reference to other units which may contain judging commands 



join causes execution of the specified unit without change of main 

unit; commands following -join- are executed; -join- is executed 
iii all states: regular, judging, and search (see also description 
under SEQUENCING, Automatic sequencing) 

join UNIT NAME 

join NAME, VAR<= INITIAL EXPR, FINAL EXPR, STEPSIZE EXPR (opt) 
join EXPR,NAMEM,NAJlE0,x,NAME2,q (example of conditional form) 



iarrow (rfsgular command) the specified unit is executed after each 

subsequent -arrow- in a unit just before the first judging command 
is executed 



iarrow UNIT NAME 

iarrow (B) or iarrow q (clears the -iarrow- setting for 
subsequent -arrow-' cor-aands in the unit) 

iarrow EXPR,NAMEM,NAME0,q,NAME2,x (example of conditional form; 
maximum of 100 arguments in the conditional tag) 

Note: The -Iarrow- setting is equivalent to -join- after each 

tii'iibsequent -arrow- (just before the first judging command); 
the specified unit is e?. routed in all states. 

iarrowa (regular command) similar to -iarrow- but is associated with 
•-arrowa-; see -iarrow- for restrictions 



iarrova UNIT NAME 
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Alteration of judgment 



judge (regular command) alters the juugment rendered by judging commands 



judge 
judge 

judge 

judge 

judge 

judge 



judg 
judge 



judge 
judge 



ok 



no 



wrong 
okqult 
noqult 
quit 



judge Ignore 



exit 

continue 



rejudge 
EXPR,x,no 



(sets judgment to "ok"; sets "judged" to -1; 
continues processing regular commands ) 
(sets judgment to "no" [unanticipated] ; sets 
"judged" to +1; continues processing regular 
commands) 

(sets judgment to "no" [anticipated]; sets 
"judged" to 0; continues processing regular 
commands) 

(sets judgment to "ok"; sets "judged" to -1; 
terminates processing at that arrow except for 
regular commends following -specs-) 
(sets judgment to '*..o"; sets "judged" to +1; 
terminates processing at that arrow except for 
regular commands following -specs-) 
(leaves judgment unchanged and terminates 
processing at that arrow except for regular 
commands following -specs-; allows the student 
to proceed to the next arrow even if judgment 
on the current arrow is "no") 

(stops all processing, erases the response, and 
waits for a new response) 

(rescinds judgment and waits for additional keys) 
(resumes judging using the modified response, 
as altered by -bump-, -put-, -specs-, -match-, 
-storen-, etc; resumes processing judging 
commands) 

(resumes judging using the original, unmodified 
response and clears the -specs- setting; 
resumes processing judging commands) 
,lgnore,ok (example of conditional form; 

argument x leaves judgment unchanged) 
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Alteration of feedback 

okword (regular command) permits "ok" message to be changed 

okword NEW WORD FOR USE WITH "OK" JUDGMENT (may be blank) 

noword (regular command) permits "no" message to be changed 

noword NEW WORD FOR USE WITH "NO" JUDC^ENT (may be blank) 

NOTE: Tags of -okword- and -noword- may have up to 9 characters. 
A space is automatically provided before the message. 
Commands -okword- and/or -noword- may be placed anywhere in the 
lesson. Once they are executed, they are in effect until execution 
of another -okword- and/or -noword- command* 

markup (regular command) (no tag) used with -specs holdmark- to display 
markup information that was inhibited with -specs holdmark'- 

markupy (regular command) specifies vertical displacement of markup 

information in screen dots from the default position of 8 dots below 
the response; tag is negative for new position below the default, 
positive for above; new position is in effect until execution of 
another -markupy- command 

markupy DOTS FROM DEFAULT MARKUP POSITION 

markupy 0 (set to default position of 8 dots below response) 
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System vai.cibles for judging 
judging in general 



anscnt number of response-matching coraraands encountered at an arrow 

before the response is matched; also set by -storen--; otherwise, 
« -2 if the student's response contains more than 39 words 
= -1 if no tag is matched 
= 0 for a store error 

zeroed for each -arrow- and each -specs- command 



ansok = -1 if the response is a satisfactory match to the preceding 
response-matching command 
« 0 otherwise; 
in particular, after -no-, 

a -1 if there is no match to a previous response-matching command 
» 0 if the match is poor 

j count number of internal 6-bit character codes in the response 

judged = -1 for any "ok" judgment 

= 0 for any "wrong" judgment (anticipated "no") 
= 1 for any "no" judgment (unanticipated "no") 
= 2 for response not yet judged 

key 

ztouchx [See descriptions under system variables for sequencing.] 
z touchy 

ntries number of attempts on the current arrow 
verbal responses 

judging commands which affect system variables for verbal responses: 

1. -match- 3. -vocabs-, -concept-, -miscon- 

2. -answer-, -wrong-, -answer c-, -wrongc- 4» -vocab-, -concept-, -miscon- 

capital = -1 if there are no capitalization errors, = 0 otherwise 
(with 1, 2, 3 above) 

entire = -.1 if all required words are present, « 0 otherwise 
(with 2 above) 
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extra « -1 if there are no extra words in the response, = 0 otherwise 
(with 2, 3, 4 above) 



order = -1 if word order is ok, =0 otherwise 
(with 2 above) 



phrase == -1 if there are no phrase errors, == 0 otherwise 
(with 1, 2, 3 above)^' 



spell == -1 if spelling is ok, = 0 otherwise 
(with 1, 2, 3 above) 

vocab = -1 if all words in the response are in the vocabulary, = 0 otherwise 
(with 3, 4 above) 

wcount number of words in the response (maximum of 39) 
(with cll above) 



numerical responses 

These systetr variables are set vlth -ansv-, -wrongv-, -ansu-, -wrongu-, 
-store-, -Suoreu-, -compute-, and the -calc- type commands • 

opcnt number of arithmetic operations and functions in the response 

(= -1 if there are no operations and the expression cannot be stored 
with -store-) 

varcnt number of defined variables and functions (define sef: "student") 
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formok gives diagnc^.tics on errors in mathematical expressions 





-1 


if 


the expression is ok 


n 


0 


if 


there is a bad function argument or index 


sa 


1 


if 


there is an illegal character 


za 


2 


if 


there are unbalanced parentheses 


XT 


3 


if 


there are too many decimal points 


cs 


4 


if 


there are variables not defined in define set "student" 


S3 


5 


if 


a symbol involving $ is not a logical or a bit operator- 




6 


if 


the expression has bad form 


33 


7 


if 


a value is assigned to a non-variable 


r= 


8 


if 


an octal constant contains digit 8 or 9 


s= 


9 


if 


there is an error in an alpha string 


r= 


10 


if 


a nureber has too many digits 




11 


if 


an array index is out of bounds 




12 


if 


there are variables with ~specs novars- 




13 


if 


there are operations with -specs noops- 


Si 


14 


if 


there are tissignments without -fi-pec-i okassign- 


«= 


15 


if 


units in the response are used incorrectly 


es 


16 


if 


too mnch computing is attempted 


sa 


17 


if 


the expression is too deep in nested functions 




18 


if 


a function has the wrong number of arguments 


r= 


20 


if 


an array has the incorrect number of arguments 




21 


if 


an array is not permitted in this expression 




22 


if 


the array size is incorrect or operation is nonconforraa' 




23 


if 


there are too many arrays in the expression 


sa 


60 


if 


too many temporary variables are needed during processing 


sa 


62 


if 


expression is too complicated for temporary storage to hold 


Bi 


63 


if 


there are too many literal numbers in the expression 




65 


if 


there is an error in a segment definition 


cs 


66 


if 


expression is too deep in indexes which nr.e assigned values 
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MANAGING SITES 



Ml 



Conmands in this section are legal only in a site lesson. 



Site commands 



These coinmands, all of which have -site- in the command field, give information 
on the specified logical site. 



site set specifies the logical site for subsequent -site- commands 
and -station- commands; a later -site set- command 
overrides an earlier one 



site set, 'SITENAME* 



Note: zr3turn « -1 if -site set- is executed successfully 

= 0 if the lesson is not a site lesson for the 
specified sitename 



site info stores current site ECS information for the sit^. specified 
by a preceding -site set- 
site info, STARTING VAR FOR STORING INFORMATION 



No^e: Information consists of: 



n(x) 0£ nc(x) « starting variable 

n(x) contains the base ECS allotment 

n(x+l) " the ECS currently allotted 

n(x+2) " the ECS currently in use 

n(x+3) " the number of artive terminals at the site 

zreturn = -1 if -site info- is executed successfully 
= 0 if no site has been set by -site set- 



site active stores the physical station numbers of the specified 
number of active stations on the site 

site active, STARTING STATION NT>^BER, STARTING VAR FOR STORING 
STATION NUMBERS, NUM ACTIVE STATIONS TO STORE 

Note: zreturn = -1 if -site active- is executed successfully 
= 0 if no site has been set by -site set- 
s' +1 if the starting station number is invalid 
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site stations stores the physical station numbers of the specified 

number of stations permanently on the site 

site stations, STARTING STATION NUMBER, STARTING VAR FOR STORING 
STATION NUMBERS, NUM STATIONS TO STORE 

Notet zreturn = -1 if -site stations- is executed successfully 
= 0 if no site has been set by -site set- 
= +1 if the starting station number is invalid 
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Station commands 



These commands, all of which ha'^^e -station- in the command fields give 
information on individual stations on the specified logical site. 



station info stores information on the specified physical station number 

station info, STATION NUMBER, STARTING VAR FOR STORING DATA 

Note: Information consists of: 

2JL nc(x) = starting variable 
n(x) and n(x+l) contain the user's name (up to 18 characters) 
n(x+2) contains the name of the user's group 
n(x+3) " the type of user 

n(x+4) " the account name containing the user's group 
n(x+5) " session statistics (in 3 20-bit fields — 

disk accesses, seconds of CPU, elapsed time in seconds) 
n(x+6) " the name of the user's lesson or type of activity 
n(x+7) " total ECS the lesson is using (in 3 15-bit fields — 

storage ECS, common ECS, lesson ECS [left-most 15-bit 

field is empty] ) 
n(x+8) " name of the user's router 

n(x+9) " ECS used by the router (same format as lesson ECS) 

zreturn « -1 if -station info- is executed successfully 
« 0 if no site has been set by -site set- 
s' 1 if the starting station number is invalid 
= 2 if the specified station is not on the site 
= 3 if the station is inactive 



station status sets "zreturn" according to the status of the specified 
physical station number 

station status, STATION NUMBER 

Note: zreturn « -2 if the station is in the process of signing on 
= -1 if the station is active 
- 0 if no site has been set by -site set- 
's 1 if the starting station number is invalid 
= 2 if the specified station is not on the site 
= 3 if the station is inactive 
a 4 if a backout of the station is in progress* 
« 5 if the station is locked out 
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station send sends the specified message (in -mode rewrite-) to the 
specified physical station number 

station send, STATION NUMBER, SCREEN LOCATION, MESS AGE, NUM 
CHARACTERS IN MESSAGE 

Note: zreturn = -1 if message is sent successfully 

= 0 if no site has been set by -site set- 
= 1 if the starting station number is invalid 
= 2 if the specified station is not on the site 
= 3 no message is at (specified station is a 

runner staticu or is the station sending the 
mesBage) 



station logout backs out the station (given by the physical station number) 
(sets "backout" to -2) 

station logout, STATION NUMBER 

Note: zreturn = -1 if the backout is successful 

= 0 if no site has been sec by -site set- 
= 1 if the starting station number is invalid 
= 2 if the specified station is ot on the site 
= 3 if the specified station cannot be backed out 



station stopl presses STOPl at the specified station (sets "backout" to 
+1 until the station enters another instructional lesson) 

station stopl, STATION NUMBER 

Note: zreturn = -1 if STOPl is pressed at the s* .-^tion 

= 0 if no site has been set by -site set- 
= 1 if the starting station number is invalid 
= 2 if the specified station is not on the site 
= 3 if STOPl cannot be pressed at the specified 
station 



station off turns off the specified station and prev^^.nts further use of 
the terminal (sets "backout" to -2) 

station off, STATION NUMBER 

Note: zreturn = -1 if the station is turned off successfully 
= 0 if no site has been set by -site set- 
« 1 if the starting station number is invalid 
= 2 if the specified station is not on the site 
« 3 if the specified station cannot be turned off 
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station on turns on the specified station 

station on, STATION NUMBER 

Note: zreturn = -1 if the station is turned on successfully 
=5 0 if no site has been set by -site set- 
= 1 if the starting station number is invalid 
= 2 if the specified station is not on ,;he site 
= 3 the station is already active 
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PRESENTING 



Basic display 



at specifies starting position of display on the screen; sets left margin 

at COARSE 

at FINEX,FINEY 

Note: The following formulas convert between character grid and 
fine grid • 

finex = 800xfrac(coarsc/100) - 8 
flney « 512 - 16xlnt(coarse/100) 

coarse = 100x{l + intt(511 - flney)/16]> + int(finex/8) + 1 

atnm like -at- but does not reset the left margin 

a tnm COARSE 
atnm FINEX, FINEY 



write displays text on the screen 

write ANY MESSAGE, WHICH MAY CONSIST OF SEVERAL LINES 
AND INCLUDE EMBEDDED INFORMATION. 

writec displays one of several messages depending on the rounded value of 
the CO nd 1 tio nal exp r e sslon 

writec EXPR{mESSAGEmJmESSAGS0{mESSAGE1{{mESSAGE3 

NOTE: The embed feature is available. See descriptions of the Individual 
commands in this section for ir:formation on FORMAT, MINIMIR^, and 
ASTERISK, which are optional. 

< show, EXPR, FORMAT, MINIMUM> or < s,EXPR,FOPmT,MINBIUM> 

< showz,EXPR,FORMAT> or < z, EXP R, FORMAT > 

< showt,EXPR, FORMAT > or < t.EXPR, FORMAT > 

< showe,EXPR,FORMAT,ASTliRISK> or < e, EXPR, FORMAT, ASTERISK> 

< sho wo, EXPR, FORMAT > or < o, EXPR, FORMAT > 

< sho wh, EXPR, FORMAT > or < h, EXPR, FORMAT > 

< showa, STARTING VAR,FORMAT> or < a, STARTING VAR,FORMAT> 

< at,COARSE> ; < ar ,FINEX,FINEY> 
^ -tnm,COARSE> ; < a tnm, FINEX, FINEY > 

. size, EXPR GIVING SIZE OF WRITING> 

< size. SIZE X DIRECTION, SIZE IN Y DIRECTION> 

< rotate, EXPR GIVING ANGLE FOR WRITING> 

< m,w> (write mode) 

< m,e> (erase mode) 
<m,r> (rewrite mode) 



embedded 


- shov- 


embedded 


es ho wz- 


embedded 


-showt- 


embedded 


-showe- 


embedded 


-showo- 


embedded 


--showh- 


embedded 


-showa- 


embedded 


-at- 


embedded 


-atnm- 


embedded 


-sl^e-- 


embedded 


-rotate- 


embedded 


-mode- 
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NOTE: In the show-type commands (-show-, -showz-, -showt-, -showe-, -showo-, 
-showh-, -showa-), the general form is 

showz EXPR, FORMAT 

where FORMAT, which tBay be an expression, is optional. 
If FORMAT equals 0, nothing is displayed. 

For displaying entire arrays, the general form is 

shc'Tt ARRAYNAME, FORMAT (for arrays with number of rows <16, 

number of columns ^64; -showa-, -showh-, -showo-, -showe- 
may also be used to display entire arrays) 

To display only the first element of an array, use 

show ARRAYNAME, FORMAT or shows ARRAYNAME, tORMAT 



show displays thi. value of a variable or an expression with the specified 
number of significant digits but with suppression of trailing zeros 
after the decimal point; expo-aential format is displayed if the 
member of digits preceding the decimal point exceeds FORl-lAT by 
more- than 4, or if the absolute value is less than 10"^; 
MINIMUM is between 0 and 1 and specifies the smallest non-zero 
value to be displayed (0 is displayed if the absolute value of 
the. expression is less than MINIMUM) 

show EXPR,NUM DIGITS, MINIMUM (FORMAT, if omitted, is 4; 
MINIMUM, if omitted, is 10"^) 

showz sirBilar to -show- but displays all digits, including trailing zeros 
showz EXPR,NUM DIGITS (FORMAT, if omitted, is 4) 



shcwt displays the value of a variable or expression in th3 specifier^ 
f oriEat 

showt EXPR,NUM DIGITS PRECEDING DECIMAL POINT,NUM DIGITS 
FOLLOWING DECIMAL POINT (may be omitted if zero) 

(FORMAT, if omlttedj is 4,3 for v-variable, 8 for 
n-variable; if the number of decimal places is less 
than 10, FORMAT may also be expressed as a single 
decimal number: e.go, 4.3 is equivalent to 4,3) 




showe displays the value of a variable or an expression in exponential 
format with the specified number of significant digits, including 
a leading blank or a minus sign; an optional third argument 
specifies the format for Che exponent 

^bowe E2PR,NUM DIGITS, ASTERISK (FORMAT, if omitted, is 4; 

ASTERISK Is omitted or «0. for exponent expressed by 
superscript, ^9 for exponent expressed by 2 asterisks and 
multiplicatio.: s^gn replaced by one asterisk) 
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showo displays the value of a variable or an expression In octal notation 

showo EXPR,NUM DIGITS DISPLAYED (FORMAT, if omitted, is 21; 
in embedded -showo- default format is 20) 



showh displays the value of a variable or an expression in hexadecimal 
notation 

showh EXPR,NUM DIGITS DISPLAYED (FORMAT, if omitted, is 16; 
in embedded -showh- c-sifault format is 15) 



showa displays characters in the specified variable(s) or specified string 

showa STARTING VAR,NUM CHARACTERS (FORMAT, if omitted, is 10) 
showa 'STRING' (STRING may contai^T?. up to 10 characters) 



hidden displays hidden as well as visible characters; (special symbols are 
used to display hidden characters); numbei of characters includes 
all 6-bit character codes 



hidden STARTING VAR.NUM CHARACTERS (opt) 



(NUM CHARACTERS, 
if omitted, is 10) 



text displays contents of an alphanumeric buffer, line by line; the end 
of a line must be indicated by a variable endiug with 2 zero codes 
(i.e., 12 bits equal to 0: 00000) (embedded zero c(fdes (o00) are 
ignored); not affected by -size- or -rotate- 



text 



STARTING VAR,NUM VARS 



erase erases the screen, selectively or entirely 

erase abort (causes a full-screen erase and aborts output) 
erase (B) £r erase NEGATIVE NUMBER (causes full-screen erase 

but does not abort output) 

erase NUM CHARACTERS TO BE ERASED 

erase NUM CHARACTERS PER LINE, NUM LINES (causes block erase) 

Note: Selective erase is affected by preceding -size-, -gorigin- 
(and -scalex-, -scaley-), and -rorigin-. 
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lang sets the system variable "zlang" 

lang english (sets "zlang" to 0) 
lang french (sets "zlang" to 1) 
lang Spanish (sets "zlang" to 2) 
lang german (sets "zlang" to 3) 

lang EXPR,french,x, english, german (example of conditional form; 
argument x leaves "zlang" unchanged) 

■' • Q ^ 
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mode specifies terminal writing mode (see also system variable "mode") 



mode 


write 


(normal writing state; writes only sel^: 


ted dc 


mode 


erase 


(erases only selected dots) 




mode 


rewrite 


(erases and rewrites in one step; does - 
with "size" ^ 0) 


ot wor 


mode 


inverse 


(only on programmable terminal; display: 
writing on light background) 


dark 


mode 


EXPR, erase, write, X, erase (example of conditional 


form; 



argument x leaves writing mode unchanged) 



Note: The mode is reset to "write" after any f ull-r-reer. erase, 
particular at a main unit not containing -inhibit erase- 



specif ies the size of line-drawn characters; remains in effect 
across main unit boundaries until turned off exvlicitly lee 
also system variables "size", "sizex", "sizey") 

size EXPR GIVING SIZE OF CHARACTERS 

size SIZE IN X DIRECTION, SIZE IN Y DIRECTION (sers i: _ ^-r.a 

sizes in x and y directions) 
size 0 o£ size (B) (restores standard wriiing) 

Note: Negative "sizex" gives backwards characters and writi..^; 

negative "sizey" gives upside down characters and wricing 
Negative "size" behaves like simultaneous negative "sizex 
and negative "sizey". 



rotate causes line-dravm characters to be written at the angle specJ.f: 
in the tag; remains in effect across main unit boarr.daries ur* 
turned off explicitly (must be used with -size- tau. 4 0) 



rotate EXPR GIVING ANGLE IN DEGREES (omit degree sjnnbol; 

measured counter-clockwise from horizontal) 
rotate 0 o:^ rotate (B) (restores horizontal wr;iting) 



delay permits wShort delays during output 

delay DURATION OF OUTPUT DELAY IN FRACTIONS OF A SECOND, U? TO 
I SECOND (accurate to 1/60 second) 

Note: This command causes "do-nothing" output to be sent to 
the terminal for the specified delay time. 
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Inhibit teiiiporarl iy .lisables ce ; 

all sett ngs are clear^ ^ 



inhibit anserase 

inhibit .irrcw 

inhibit jiani:- 

inliibit aari^-ear 

inhibit -iropiiile 

inhibjt - - r . c :: 

lnhl?>it e. :_: 

Inhltl: -r-se 

inhibit t — rra 



Ltihlbit mnjpch 
.nhibi^ irm 



_n normal actions of TITOR ^n a unit; 
..: each main unit 



_nhibi: ( 



.^hibi 



(p: ts autonatic erasure of anrver-contingent 

mes- vhen a response Is erased. 

(pr ^uts plotting of the response i;row) 

(pr tii^r^ judging if NEXT is presst€: before 

any ru-nracters are typed} 

(pr iints clearing of the c::arset f.ag) 

(pr - :s the attached file £r m being released 

dur ip . jimpout) 

vpr :s storage from baing dropp:^. during 
a ^ Lit) 

m: zs use of the SDIT key) 
(r: urils normal full-screen erase ;:\en 
"7 : ui ng to the next main unit) 
vz -r^TTzs return to the lesson cor :aining . 
:t«L, catement via -jumpuuc return- or 

)uc return, return- ) 

^nts ECS check before att^- ' a jumpout) 
"ts use of the TERM kev) 
- . ^-ar (removes effe • o: ize'^Lons -inhibit- 
commands in tiiHt unit) 
- ^nki. (may combine t^- is) 



rermi ~ roecifi it r o: ~£ tially designed cha: riter -. fcr display 

char .^E,Ar :^1,ARG2. .-i J3, ARG4, ARG5, ARG6,ARG' 

^^ote' character name r'AME) Triay be a nurabe^ roir: ' to 126 

.:;:cluding 63) or £ defined name. Argune:- t3 All 1 through 
t^']8 are numbers v ich specify which of ziie 16 ^ots are 
lit in each of the columns of the Jihar^ttter r::ice« 



for ^jixample: 

cefire thi-8a $$ load chi on X 

char 2hi,o4i320,ol0040,o6300,ol600,o3140,o4020,oi00^ :* 



plot d:Lscl^rr a special character previously specified by a -char- 

cctunaan: 

plct NAME 

plat ZXPR (EXPR may have value from 9 to 126, exc idlng 63) 

Note: ipeciai characters may also be displayed by :pre3-:^_ng . 

the FONT key and then the key(s) where the charairi^r (s) 
are loaded into the terminal memory. Built-in cthi:acters 
see displayed after FONT is pressed again. 
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ith -c. . 
creen 
ine gr- 



.z.- *draw-5 -box-, -fill-, -vector-, -window-, LCCATTl^N _3 the 
-'.ration and nay be COARSE or FINEX,FINEY. Coc: 'se :rid and 
.:: :roordlnate : may be mixed in tags with more the . or.: argument. 



draws c _ot at the specified screen location 
:ot JCATION 



crax ^ a act, llne^ ct l_ne-drawn figure; after executr.on3 ^^.^erex" 
'2r:d '"'"vrairej" are sec r. the last poin" plotted 

draw LOCATION (dr^ws a dot; -dot- is faster if many dots are 

plotted; — : :'aw- Is faster if lines are also being drawn) 
draw LGi::ATIONl;L0CA. T0N2 (draws a 1 e) 

draw 1.j:ATI0N1;I'^ ^li-.: 0N2;L0CATI0N:;.. draws connected lines) 

dr—-^ ;1CCATI0N ::: . .vs a continued 1..:-: 

ire ' I^or.ATIONl;:. 1" .::?T2;skip ;LOCATIOl 'L ]ATrON4 

^"skip ^ ^r-r^ no a new positlc ^.thout plcr^iing) 

Kota: fiiz^zzium number numbers In the r is 63 ("skip'^ counts 

:) 



draws ^ -^ tangle with rh - specified corner locations and thickness: 
after eiL-a^-.-tlon, ''wherex" "wherey" are se> to the lower left corner 
:)f the ::^rx with thickness included 

box CC'ENER LOCATION ;07r3SITE CORNER LCJIJION ;DOTS THICK (opt) 

box ;^ORNER LOCATION;!: ': ::S THICK (opt) opposite corner at curren 

'wherex", "wherey") 
box CORNER LOCATION (opposite corner ez 0,0; cannot specify 

•-nlckness with this form of tag) 
box 3) equivalent :j -box 0,0;51l5 511-) 

Note Thickness, if omitt:d, 0, 1, or -1 is 1 dot. Negative 

thickness extends irward ; positive thickness extends outward . 
Maximum thickness is 95 (or -95). 



illli: In a rectangular area on the screen on programmable terminals; 
does not affect the setting of "wherex", "wherey" 

till CORNER L-OCATION;OPPOSITE CORNER LOCATIGi:^ 

fill ;CORNER LOCATION (opposite corner at "wherex",' "wherey") 
fill (B) (fills In the entire screen. I.e., corners 0,0;511,511) 
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vector draws a vector symbol with specified tail and head locations and 
head size 

vector TAIL LOCATION ;HEAD LOCATION ;SIZE (opt) 

vector ;HEAD LOCATION;SIZE (opt) (tail at "wherex'*, "wherey") 
vector HEAD LOCATION (tail at 0,0 ; cannut specify head size) 
vector 0,0;HEAD LOCATION;SIZE (tail at 0,0 ; head size specified) 

Note: SIZE, if omitted, is 10 or 11 dots for moderate-length vectors. 
Negative size indicates open arrowhead. 

I size 1^1 is absolute (in screen dots); |size|<l is relative 
to the length of the vector. 



window establishes a rectangular "window" on the screen outside of which 
line-drawn display is not plotted; remains in effect across main 
unit boundaries until turned off explicitly 

window CORNER LOCATION ;OPPOSITE CORNER LOCATION 

window ;CORNER LOCATION (opposite corner at "wherex", "wherey'' 

window CORNER LOCATION (opposite corner at 0,0) 

window (B) (clears previous --window- setting) 



circle draws a circle with the specified parameters; the center is at the 
current "wherex", "wherey"; after execution, "wherex", "wherey" are 
set to the center for a one-argument tag and to the end of the last 
line drawn for the three-argument tag 

circle RADIUS IN DOTS, START ANGLE (opt), END ANGLE (opt) 

(second and third arguments are optional: if omitted, 
START ANGLE is 0° and END ANGLE is 360°; angles 
are measured in degrees counter-clockwise from 
START ANGLE; degree sign is omitted) 



iircleb same options as -circle- but draws a broken circle 

circleb RADIUS IN DOTS, START ANGLE (opt), END ANGLE (opt) 
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Relocatable graphics 



rorigin est£:hiishes a "relocatable" origin fc ifu - dra -rat-, 

-rbr::-, -rvector-, and -rcircl 

rori-.rin COARSE 
roriigln FINEX,FINEY 

rorigin (B) (sets relocatab^ : origi: f 'Vi::.. , "wbsrey") 

Note; Upon entering a lesson. :h6 -gia 
automatically set to origi-n 



NOTE: All subsequent relocatable commands are e(iZ:,._: preceding 
-rorigin-, -size-, and -rotate-. 



rat similar to -at- but relative to tht - » Lg: It cation: affected 

by preceding -size- and -rotate- 
rat X-L0CATI0N,Y-LOCATI0N 

rat (B) (equivalent to -rat 0, ^-. ne current 

-rorigin- location) 



ratnm similar to -rat- but does not reset : : nar^in (see -atnm-) 

ratnm X-LOCATION, Y-LOCATION 



rdot draws a dot at the specified position :l i ■ e r;o the -rorigin- 
location; position is affected by pr ce -rn ^i::e- and -rotate- 

rdot X-LOCATION, Y-LOCATION 



rdraw similar to -draw- but figure is affe y ^^receding -size- and/or 
-rotate-; the last point plotted se iae location for the next 

screen activity 

rdraw TAG LIKE -draw- EXZEPT WITH :: : CT TO -rorigin- LOCATION 

(i.e., in screen dc ts from t origin- location) 



rbox similar to -box- but draws a rectang^a r Lative to the -rorigin- 
location; affected by preceding -size- id ■ -rotate- (see -box-) 

rbox CORNER X,.CORNER Y;a2>P0SITE CORNE X,OPPOSITE CORNER Y; 
DOTS THICK (opt) 

rbox ;CORNER X, CORNER YpOTS THICK (op ) (opposite corner at 

"wherex", "wherey") 
rbox CORNER X, CORNER Y (opposite corner at -rorigin- location; 
cannot specify thickness with rhis form of tag) 
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rvector slmi . to -vect -r- h-Z draws vector symbol relative to -he -r^:^: gin- 
locac^on; affecte by preceding -size- and -rotate^ (see -vect r-"* 

rvectcr XTAIL, YTAl ^; . : .D,1HEAD -IZE (opt) 

rvectc-: ;XTAIL,XHIliD _ Z (opt) (tail at ' wherex'% ''wherey") 

rvectc * XHEAD^YHEr-j r.all at -rorlgln- location) 

rvectc 0,0;XHEAD, "HZjII zSIZF ^:all at -rorigln- location) 



rclrcle sz.ine r -tlons as -c^rc - :fferted by preceding -rotate- 

-size- gives an e^li - li ..-aded by two-;E.rgum?.nt -size- wit 
unequa arguments ,s^*: -ci^r- 

rcircl- RADIUS IN r^'ZSS.I' k'rZLZ (opt), END ANGLE (opt) 

(specify basi-c :dii-3 before affected by -size-) 
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Dra^ng graphs j 

g:L .:- -.n specifies l.ca-^ion of the origin o: ::ie graph; all ther display 
with graphi . ;^ commands is relativ ' : this origin 

gorigin COi:.- 3E 
gorigin FniZ:i,FINEY 

gorigin (B) (sets graph origin "vTherex", '"-ihEziziy") 

lOte: Upon entering a lesson, th_ ,^rzigin is ^uitom^ rlcally set 
to -gorigin 0,0-. 

axes specifies lengths of the axes and ::r£ws the axes; laniains in effect 

across main unit boundaries until reset; x and y values are in dots 
relative to the -gorigin- locatior 

axes NEGATIVE X,NEGATIVE Y,POSITIVE X,POSITIVE 
axes POSITIVE X, POSITIVE Y 

axes (B) (draws axes specified by the lasr -a ;es- or -bounds-) 

Note: To draw one-quadrant axes (other than both positive axes) with 
labeling on the outside of the axes, use f cur*-argument form of 
the tag with arguments corresponding to mirsivig axes set to 0* 

( 

bour.^^ specifies lengths of the axes but does not draw the axes (i.e., axes 
are invisible); remains in effect across main unin boundaries until 
reset; x and y values are in dots relative to the -gorigin- location 

bounds NEGATIVE X, NEGATIVE Y, POSITIVE X, POSITIVE Y 
bounds POSITIVE X, POSITIVE Y 

bounds (B) (sets up bounds specified by the last -axes- or -bounds-) 

Note: Upon entering a lesson the boundaries are automatically 
.set to -bounds 511,511-, 

scalex specifies the maximum value and the value at the origin on the 

X axis; remains in effect across main unit boundaries until reset 

scalex MAXIMUM VALUE OF X, VALUE OF X AT ORIGIN (opt) 
(value at origin, if omitted, is 0) 

scaley same options as -scalex- but for the y axis 

scaley MXIMUM VALUE OF Y, VALUE OF Y AT ORIGIN (opt) 
(value at origin, if omitted, is 0) 

( 
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Iscalex specifies the ra£z::in:zin value and the value at the origin on the 
X axis; the 3ca.l_= batween these points is proportional to the 
logarithm of mazzzjnum x divided by the value at the origin; remains 
in effect across main unit bcundariies until reset 

Iscalex MAXIMUM jAI'JE OF X, VALUE 07 X AT ORIGIN (opt) 

(valiH t origin, If ar.:tzed. Is 1, i.e., 10^) 

Iscaley same options as ^ -.lex- but for i y axis 

Iscaley MAXIMUM LUE OF Y, VALUE OF Y AT ORIGIN (opt) 

(valzc It origin. If omitted, is 1, I.e., 10^) 

NOTE: If any of the coirT::nards -scalex-, -scaley-, -Iscalex-, -Iscaley- are 
omitted, a linear scale with length set by the preceding -axes- or 
-bounds- Is assu.^^d- 



NOTE: Subsequent grap'r :ng commands are : appropriate scaled units. 

labelx draws tick marks and labels the j: axis 

labelx MAJOR INTERVAL, MINOR INTERVAL (opt ) ,MARKSIZE (opt ) .FORMAT (opt) 

labely draws tick marks and labels the y axis 

labely MAJOR INTER "AL,MTKJ I JxTERVAL (opt ), MARKS IZE (opt ), FORMAT (opt) 

markx draws tick marks on the axis with no labels 

markx MAJOR INTERVAL, MINOR INTERVAL (opt ) ,MARKSIZE (opt ), FORMAT (opt ) 

marky draws tick marks on the y axis with no labels 

marky MAJOR INTERVAL, MINOR INTERVAL (opt ) ,MARKSIZE (opt) , FORMAT (opt) 

NOTE: Commands -labelx-, -labely-, -markx-, -marky- specify major and minor 
mark Intervals. 

MARKSIZE « 0 or omitted for normal label marks 

MARKSIZE = 1 for major marks extending to bounds of the graph 

MARKSIZE = 2 for all marks extending to bounds of the graph 

MINOR INTERVAL may be omitted. If MAJOR INTERVAL is set to 0 with 

linear scale, the computer chooses the "best" Interval. 
The total number of marks on an axis cannot exceed 100. 
FORMAT gives the format for the labels and has the same form as that 

for -showt-, e.g., 1.2 or 1,2. FORMAT Is optional; If omitted, the 

label format is selected automatically* 



(NOTE continued on next page*) 
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NOTE: (continued from preceding page) 
For labeling log scales: 

MAJOR INTERVAL mu3t be (J (major marks are automatically plotted every 
decade) 

MINOR INTERVAL < 0, minor marks are not plotted 

MINOR INTERVAL = 0 or 3 (or omitted), minor marks are placed at values 

of 1, 2, 5 within the decade 
MINOR INTERVAL = 5, minor marks are placed at 1, 2, 3, 5, 7 
MINOR INTERVAL = 10, minor marks are placed at 1, 2, 3, 4, 5, 6, 7, 8, 9 



polar causes tags of graphing commands to be intertireted as polar 

coordinates containing scaled radius and polar angle; may set scales 
on X and y axes; remains in effect across main unit boundaries 
until turned off explicitly; polar conversion and scaling must be 
turned off independently 

polar (B) (turns on polar conversion) 

polar MAXIMUM VALUE OF X AND Y (turns on polar conversion 

and scales both axes) 
polar ^lAXIMUM VALUE OF X, MAXIMUM VALUE OF Y (turns on 

polar conversion and scales axes ind/;pendently ) 
polar NEGATIVE VALUE (turns off polar conversion but not scale) 



NOTE: When the tag of subsequent commands is interpreted in polar 

coordinates, the degree sign must be used if the angle is in degrees* 
Without the degree sign, the angle is interpreted in radians* 

gat similar to -at- but specifies the screen lo.?.ation relative to the 

-gorigin- location and in scaled units 

gat X-LOCATION, Y-LOCATION 

gat DISTANCE, ANGLE (with -polar-) 
* gat (B) (equivalent to -gat 0,0-, i»e., the current 

-gorigin- location) 



gatnm similar to -gat- but does not reset the left margin (see -atnm-) 

gatnm X-LOCATION, Y-LOCATION 

gatnm DISTANCE, ANGLE (with -polir-) 
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gdot draws a dot at the specified position relative to the -gorlgln- 
locatlon and In scaled units 

gdot X-LOCATIOU, Y-LOCATION 

gdot DISTANCE, ANGLE (with -polar-) 



graph places a dot or character string centered at the position Indicated 
relative to the -gorlgln- location and in scaled units 

graph X-LOCATION,Y-LOCATION, STRING (opt) (maxlraura of 9 

characters in string; if string is not specified, a 

dot is plo*:ted) 
graph DISTANCE, ANGLE, STRING (with -polar-) 
graph X-LOCATION,Y-LOCATION;VAR,NUM CHARACTERS (opt) 

(if number of characters is omitted, 10 characters 

are plotted) 

graph DISTANCE, ANGLE ;VAR,NUM CHARACTERS (with -polar-) 



gdraw like -draw- but relative to the -gorlgln- location and in scaled units; 
after execution "wherex'", "wherey" are set to the last point plotted 

for example: 

gdraw X1,Y1;X2,Y2 (draws a line on the graph) 

gdraw DISTANCE1,ANGLE1;DISTANCE2,ANGLE2 (with -polar-) 



gbox same options as -box- but draws a rectangle relative to the -gorlgln- 
locatlon; affected by preceding -scalex- and -scaley- (see -box-) 

gbo> CORNER X,CORNER Y;OPPOSITE CORNER X,OPPOSITE CORNER Y; 

DOTS THICK (opt) 
gbcx DISTANCE CORNER, ANGLE CORNER ;DISTANCE OPPOSITE CORNER, 

ANGLE OPPOSITE CORNER;DOTS THICK (with -polar-) 
gbox ;CORNER X,CORNER Y;DOTS THICK (opt) (draws a box 

with opposite corner at current "wherex", "wherey") 
gbox ;DISTANCE CORNER, ANGLE CORNER;DOTS THICK (with -polar-) 
gbox CORNER X, CORNER Y (draws a box with opposite corner at 
-gorlgln- location; cannot specify thickness with this 
form of tag) 

gbox DISTANCE CORNER, ANGLE CORNER (with -polar-) 
gbox (B) (draws a box set by a previous -axes- /-bounds- and 
-s c al ex- /-seal ey - ) 




gclrcle same options as -circle- but is affected by preceding -scalex- and 

-scaley-; draws an ellipse if the -scalex- and -scaley- settings are 
different (see -circle-) 

gclrcle RADIUS IN DOTS, START ANGLE (opt), END ANGLE (opt) 

(specify basic radius before affected by -scalex-, -scaley-) 
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gvector same options as -vector- except draws vector symbol relative to the 
-gorigin- location and in scaled units (see -vector-) 

gVector XrAIL,YTAIL;XHEAD,YHEAD;SIZE (opt) 

gvector DISTANCETAIL,ANGLETAIL;DISTANCEHEAD,ANGLEHEAD;SIZE(opt) 
(with -polar-) 

gvector ;XHEAD,YHEAD;SIZE (opt) (tail at "wherex", "wherey") 
gvector ;DISTANCE HEAD, ANGLE HEAD;S1ZE (opt) (with -polar-) 
gvector XHEAD,YHEAD (tail at -gorigin- location) 
gvector 0,0;XHEAD,YHEAD;S1ZE (tail at -gorigin- location) 
gvector LENGTH, ANGLE (tail at -gorigin- location; with -polar-) 

Note: Because of the default conditions of -gorigin 0,0- and 

-bounds 511,511-, -gvector- used without preceding -gorigin- 
and -bounds- gives the same result as -vector- with fine-grid 
coordinates* 



vbar draws a vertical bar at the specified location relative to the 
-gorigin- location and in scaled units 

vbar X-LOCATION, HEIGHT, STRING (opt) 

vbar DISTANCE BAR TOP, ANGLE BAR TOP, STRING (with -polar-) 
vbar X-LOCATION, HEIGHT ;VAR,NUM CHARACTERS (opt) 
vbar DISTANCE BAR TOP, ANGLE BAR TOP;VAR,NUM CHARACTERS 
(with -polar-) 

hbar draws a horizontal bar at the specified location relative to the 
-gorigin- location and in scaled units 

hbar LENGTH, Y-LOGATION, STRING (opt) 

hbar DISTANCE BAR END,A1^GLE BAR END, STRING (with -polar-) 
hbar LENGTH, Y-LOCATION;VAR,NUM CHARACTERS (opt) 
hbar DISTANCE BAR END, ANGLE BAR END;VAR,NUM CHARACTERS 
(with -polar-) 

NOTE: With -vbar- and -hbar-, STRING inay have up to 9 characters. If STRING 
is omitted, a rectangle is drawn. If the character string is stored in 
a variable and number of characters is omitted, 10 characters are drawn« 



1 n o 



ERIC 



P15 



delta specifies stepsize for subsequent -funct- commands 
delta STEPSIZE 

Note; If -delta^ is omitted, the stepsize is set to 1 . 



funct plots the curve specified in the tag, with the stepsize given by a 
preceding -delta- or by the stepsize given in the tag 

funct FUNCTION EXPR, INDEPENDENT VAR 

Note: Range of independent variable is set by boundaries of 
-axes- (or -bounds-) and -scalex- commands. 

funct FUNCTION EXPR, INDEPENDENT VAR^ INITIAL, FINAL, STEPSIZE 

Note: If initial or final values of the independent variable are 
beyond previously set boundaries, the latter are used. 
For polar functionij ii initial or final value is omitted, 
it is assumed to be 0 or Ztt, respectively. 

With either form of -funct-, a v-variable is recommended 
for the independent variable. 



NOTE: With -delta- and -funct-, select a stepsize that gives a smooth graph 
but plots quickly* A reasonable lower limit to the stepsize for a 
graph with linear x axis is: 

ISTEPSIZEl > .02x IFINAL VALUE - INITIAL VALUE | . 



100 



P16 



Non-screen 



slide operates the slide projector and selects the specified slide 

slide SLIDE NUMBER (value from 0 to 255) 

slide R0W+16xC0LUMN (ROW, COLUMN from 0 to 15) 

slide 512 (turns off lamp) 

slide 256 (closes shutter) 

slide 512+SLIDE NUMBER (selects slide with lamp off) 

slide 256+SLIDE NUMBER (selects slide with shutter closed) 

slide noslide (selects slide 0, turns off lamp, closes shutter) 

audio sends the value of the tag (truncated to 15 bits) to the external 
device connected to the "audio" jack 

audio EXPR 



play plays the audio device recording at the message location specified 
play TRACK, SECTOR, NUM SECTORS (128 tracks, 32 sectors each) 

record records a message at the location specified 
record TRACK, SECTOR, NUM SECTORS 



enable allows input from the touch panel and from external devices 

enable touch 
enable ext 

enable touch, ext (may combine tags) 

Note: -enable touch- must be reset for each -arrow- command in a 
unit and after any full-screen erase. 

-enable touch- in a unit Wxth no -arrow- allows any touch 
on the screen to have the effect of 'pressing NEXT, 
-enable ext- is turned off only by -disable ext-. 



disable prevents input from any device except the keyset; this is the normal 
state of the terminal 

disable touch 
disable ext 
disable touch, ext 
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ext sends the value of the tag (truncated to 15 bits) to an external 

device (or to the device at another station if "ext" option has 
been turned on by the receiving user) 

ext EXPR 

ext EXPR, STATION 

Note: zreturn « -1 if data is sent successfully 
« 0 otherwise 



ex tout sends the value of the right-most 16 bits of the specified variables 
to an external device; the 16th bit from the right determines how the 
information is interpreted: 1 for ext, 0 for audio 

extout STARTING VAR,NUM VARS (opt) (NUM VARS, if omitted, is 1) 



xout sends data (in 8-bit bytes) contained in the specified variables to 
an external device (available only on programmable terminals) 



xout DEVICE ADDRESS (establishes an address for use by subsequent 

-extout- or -ext- commands) 
xout ADDRESS, STARTING VAR,NUM BYTES, SEGMENT SIZE (opt) 

(SEGMENT SIZE, if omitted, is 60; if SECMENT SIZE > 8, 

only the right-most 8 bits are sent) 

Note: zreturn = -1 if the data is sent successfully 

= 0 if STOP or STOPl is pressed during transmission 



xin collects data (in 8-bit bytes) from an external device and stores it 

in the specified variables (available only on programmable terminals) 

xin DEVICE ADDRESS (establishes an address to be read upon 

subsequent external interrupt requests) 

xin ADDRESS, STARTING VAR,NUM BYTES, SEGMENT SIZE (opt) 

(SEGMENT SIZE, if omitted, is 60; if SECMENT SIZE > 8, 

the right-most 8 bits of "key" are stored, right-justif ied, 

in each segment) 

Note: zreturn = -1 if the data is received successfully 

= 0 if STOP or STOPl is pressed during transmission 



beep (no tag) rings the sound device on programmable terminals 



NOTE: Commands -xout-, -xin-, -beep- may be used only at a programmable 
terminal • 

For current information on device addresses, see the descriptions of 
-xin- or -xout- in "aids". 
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saylang specifies the language to be spoken by a phonemic synthesizer which 



is operated by the terminal (languages currently available: WES 
[World English Spelling], ipa [International Phonetic Alphabet], 
Esperanto, and Spanish); currently works only with Votrax model VS-6 

saylang LANGUAGE 

saylang (B) or^ saylang q (turns off subsequent -say- commands) 
saylang E XPR,LANGUAGEM, LANGUAGE 0, q , LANGUAGE 2, x (example of 



conditional form) 



say 



specifies the sentence to be spoken by the synthesizer 



say 



SENTENCE OR PHRASE 



(may include embedded information) 



sayc 



specifies the senten'ie to be spoken by the synthesizer depending 
on the value of a conditional expression 



sayc EXPR{pHRASEm{pHRASE0{pHRASE1 ... 
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Special dlspJ.ay 

tabset sets tabs which are used by a student pressing the TAB key 

tabset OCTAL NUMBER CONTAINING 10 PACKED TAB SETTINGS FROM 

LEFT TO RIGHT (each setting is a G-bit octal number giving 
the horizontal character position; unused settings to 
the right must be filled with octal zeros) 

for example, to set tabs at horizontal character positions 
8, 21, 30, 48, 56, and 63, use: 

tabset ol0 25 36 60 70 77 0^ 00 00 00 

Note: The tag may be an n-variable which contains the packed settings. 

micro specifies raicrotable definitions used when the student presses the 
MICRO key and then another key; unless specified, microtable and 
-micro- command are in the same lesson 

micro (0) , MICROTABLE NAME 
micro . (zlesson) , MICROTABLE NAME 
micro , MICROTABLE NAME 
micro MICROTABLE NAME 

micro LESSON NAME, MICROTABLE NAME (LESSON NAME contains the 

microtable; enclose variable arguments in parentheses) 
micro <LESLIST POSITIO>:>, MICROTABLE NAME 

micro (B) (cancels microtable in effect and restores built-in 
microtable definitions) 

Note: zreturn -1 if the microtable is available 
= 0 if the microtable is not found 



charset causes the specified character set to be loaded Into the terminal 
memory (see -inhibit charclear-); 1-block charset may contain 
up to 79 characters, 2-block charset up to 126 characters; unless 
specified, the charset and -charset- command are in the same lesson 

charset (0), CHARSET NAME 
charset (zlesson) , CHARSET NAME 
charset , CHARSET NAME 
charset CHARSET NAME 

charset LESSON NAME, CHARSET NAME aESSON NAME contains the charset 

blocks; enclose variable arguments in parentheses) 
charset <LESLIST PCS ITION>, CHARSET NAME 
charset (B) (clears charset flag) 

If the character set is loaded successfully 
If the character set is not four.d 
if the STOP key is pressed during loading 
if there is an error in loading 
If there is a disk error 

if the variable for the charset name equals 0 

113 




Note: zreturn =-1 
= 0 
= 1 
= 2 
= 3 
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chertst allows check for presence of a character set in the terminal memory; 
sets "zreturn" to -1 if the charset flag is set and to 0 if not 

chartst (0), CHARSET NAME 
chartst (zlesson) , CHARSET NAME 
chart3t , CHARSET NAME 
chartst CHARSET NAME 

chartst LESSON NAME, CHARSET NAME (LESSON NAME contains the 

charset; enclose variable arguments in parentheses) 
chartst <LESLIST PC SIT ION >, CHARSET NAME 



lineset allows use of line-drawn characters, which are affected by preceding 
-size- and rotate-; "size" must not be 0; linechars are accessed by 
the FONT key or by -altfont on- ; a lineset may be up to 3 blocks 
long; 1 block may contain up to 128 small linechars; unless specified, 
lineset blocks and -lineset- command are in the same lesson 

lineset (0), LINESET NAME 
lineset (zlesson) , LINESET NAME 
lineset , LINESET NAME 
lineset LINESET NAME 

lineset LESSON NAME, LINESET NAME (LESSON NMIE contains the 

lineset; enclose variable arguments in parentheses) 
lineset <LESLIST POSITION>, LINESET NAME 

lineset (B) (cancels lineset in effect and restores standard 
sized writing) 

Note: zreturn = -1 if the lineset is attached successfully 
= 0 if the lineset is not found 
= +1 if there is an error in the lineset 



altfont changes font mode of the terminal; affects charsets and linesets 

altfont on or^ altfont 1 a£ altfont alt (switches terminal 

to alternate font) 
altfont off or_ altfont 0 £r altfont normal (switches 

terminal to normal font, which is the default state) 

Note: Tag may be calculated, but it must be exactly 0 or 1. 

Altfont setting remains in effect across unit boundaries 
antil reset by another -altfont- command or until -jumpout- 
Is executed. 
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System variables for presenting 



mode = -1 with -mode erase- 

= 0 with -mode recite 

= 1 with -mode write 

- 2 with -mode inverse 



'- 1 



see -mode- command 



size current value of the tag of the single-argument -size- command 
(see -size- command) 



sizex current value of the "x" argument in the two-argument -size- command 
sizey current value of the "y" argument in the two-argument -size- command 



where character-grid location fcr next display 
wherex fine-grid x location for next display 
wherey fine-grid y location for next display 



See CALCULATING, 
>• System functions, 

for zfinex(X), zfiney(X) 



zlang useful for display of multi-lingual text; set by -lang- command 
= 0 for -lang english- 
= 1 for -lang french- 
= 2 for -lang spanish- 
= 3 for -lang german- 



Additional notes on PRESENTING 



ROUTING 



Router lesson 



route used in a router lessc 
lesson the user is ser 



^c±f'/ to which unit in the router 
lea^'ing the instructional lesson 



route end lesson, UNT' (e>:it via -end lesson- or -j;iinpout q-) 

route error, UNIT NA^: j^xit via execution error or condense error) 

route finish, UNIT NAME (exit via STOPl) 

route resignon,UNIT NAME (opt) (upon STOPl exit from a lesson, 
provides the user with a choice page offering the option 
to sign off completely or to continue working 
ti.3., to return to the router, to the specified unit, 
if given, or to the first unit if UNIT NAME is omitted]) 



routvar (non-executable) sets up special variables in a router lesson which 
can be used only in the router lesson; they are referenced by 
vr and nr 



routvar NUM VARS (maximum of 64 variables) 



allow used in a router lesson to specify that router common and/or 

router variables may be referenced in the instructional lesson 

allow read (read-only access to router common) 

allow write (read and write access to router common) 

allow read rvars (read-only access to router variables) 

allow (B) (clears last setting of -allov;-) 
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Curriculum information 



NOTE: The following ::ommands are used in instructional lessons. 

lesson sets the system variable "Idone" to indicate whether a lesson is 
considered complete 

lesson complete (sets "Idone" to -1) 

lesson incomplete (sets "Idone" to (J) 

lesson no end (sets "Idone" to +1; may be used in lessons with 
no logical end) 

lesson EXPR, complete, incomplete, X, no end (example of conditional 
form; argument x leaves "Idone" unchanged) 



score places value of the tag, rounded to the nearest integer, into the 

system variable "Iscore" 

score EXPR (value from 9 to 100) 

score (B) (sets "Iscore" to -1) 



status places the value of the tag, rounded to the nearest integer, into 
the system variable "Istatus"; allows a student to reestablish a 
status (to some extent) upon returning to a lesson after having 
entered other lessons 

status EXPR 
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System variables for routing 



errtype 



= 0 



for unknown error type 



« 1 for execution error 

= 2 for fatal condense error or for attempted jumpout to a router 

not specified for the group 
= 3 for memory exceeded 

= 4 for error in the finish unit of the instructional lesson 
= 5 for exit from the condense queue via STOPl 



Idone . = -1 if the user has encountered -lesson complete- or 



-end lesson- 

= 0 if the user has encountered -lesson incomplete- or has never 
entered the lesson or^ has entered but not completed the 
lesson (-records Idonelist- returns a value of 2 for the 
last case when "mrouter" is used) 

= +1 if the user has encountered -lesson no end- 



Iscore rounded value of the tag of -score- (value from 0 to 100); initially 



set to -1 for a student routed by "mrouter"; may also be set to -1 
with -score (B)-; initially set to 0 for a student not routed by 
"mrouter" 



Istatus rounded value of the tag of -status- 

rcallow = 0 for no access to router common 
= 1 for -allow read- 
= 2 for -allow write- 



router name of the router lesson (left-justified; display with -showa-) 

rstartl name of the lesson from the last -restart- command 
(left-justified; display with -showa-) 



rstartu name of the unit from the last -restart- command 
(left-justified; display with -showa-) 

rvallow = 0 for no access to router variables 
« 1 for -allow read rvars- 
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sleserr gives detailed information on fatal errors which can occur when 
accessing a lesson (i.e., errors that give a student the message 
"Call Your Instructor") 





0 


if there is no error or if the error is non-fatal 




1 


if the condensor is not available 




2 


if the lesson does not exist 


= 


3 


if the lesson source code is too long 




4 


if ECS is not available (although the site ECS allocation is 






not exceeded) 


= 


5 


(system error) 




6 


if there is a disk error 


2= 


7 


if there is a unit which is too long 


= 


8 


if the lesson has been deleted 




9 


(not used) 


= 


10 


if there is no room in ECS for the lesson common 


= 


11 


if the common is not found 


X3 


12 


if there are not enough common blocks 




13 


(system error) 


— 


14 


if there is a common codeword error 




15 


if there is a tag which is too long 




16 


if the lesson binary is too long 




17 


if the lesson is not a TUTOR lesson 




18 


if the lesson is temporarily unavailable 


= 


19 


if the site ECS allocation is exceeded 


SI 


20 


(system error ) 





21 


(system error) 




22 


if there is an error in specifying the router 


ES 


23 


if there is a Jumpout codeword error 




24 


if the common in ECS has a different length from the length 






specified in the -common- command 




25 


if a jumpout to the wrong router is attempted 




26 


if there is an error in the -use- command (other than 






"block not found") 




27 


(system error) 




28 


if the lesson is in the improper lesson access class 






(not used on the CERL system) 




29 


(not used) 




30 


if the lesson is obsolete and must be converted 




31 


if there is an error in the -use- command; block not found 




32 


if the processor lesson is not a valid TUTOR file 
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Basic sequencing 

unit names and Initiates a section of a lesson (called a unit) whicli may 
be referenced by other sequencing commands 

unit NAME (maximum of 8 characters In NAME) 

unltop similar to -unit- but without a full-screen erase when the unit is 

entered (except upon initial entry into a lesson); "mode** and **where 

are not altered 

unltop NAME (maximum of 8 characters in NAME) 

NOTE: Initial entry unit (leu) refers to commands preceding the first -unit 
or -unltop- command in a lesson; these are executed whenever and 
wherever a lesson is entered (except when a lesson executes -jumpout- 
to Itself or when a router lesson is returned to during the session) . 

See -define- for formats for a local define set, which is declared as 
a continuation of a -unit- command- 



entry names a section of a lesson which may be referenced by other 

sequencing commands; does not affect the flow of execution of the 
unit in which the -entry- command is placed except that -entry- may 
not be placed within the range of -branch-, -doto-, -if-, or -loop-; 
no keypress is required to execute commands following -entry-; 
no full-screen erase or other main-unit initializations occur 
following -entry- when it is executed within a unit 

entry NAME (maximum of 8 characters in NAME) 

NOTE; Commands -unit-, -unltop-, and -entry- may have a form with arguments: 
unit NAME(VAR1,VAR2,VAR3,...) (up to 10 arguments) 

A lesson may have up to 394 different units referenced by -unit-, 
-unltop-, and -entry-. No unit may be named "q" or "x". 
Maximum length of a unit is 500 condensed words. 
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Automatic sequencing 



NOTE: The following commands (-jump-, -goto-, -do-, and -join-) may have a 
conditional form, e.g., 

goto EXPR,-NAMEM,NAME0,NAMEl,x,NAME3,q 

do EXPR,NAMEM,NAME{),x,NAME2,q,VAR<= INITIAL, FINAL, STEP 

Argument x Is equivalent to absence of the command; argument q Is 
equivalent to a branch to an empty unit. Special case occurs with 
-do c (,-joln q-), which Is equivalent to -goto q-. For Iterative 
-do-, q ter. Inates the -do-, and x Indicates no Iteration Is done for 
that value o^ the conditional expression. Argument q Is not valid with 
-jump-. Up to 100 arguments are permitted In the conditional tag. 

These commands may pass up to 10 arguments, e.g., 

goto NAME (VALUE 1, VALUE 2, , VALUE 4) (values may be expressions) 

. 

unit NAME(VAR1,VAR2,VAR3,VAR4) (VAR3 Is unchanged) 

or 

do NAME (VALUE 1, VALUE 2 ;VAR1,VAR2,VAR3) (-return- returns 

values to VARl, VARl, VAR3) 

I 

jump causes execution of the unit named In the tag with a full-screen 
erase (unless the erase Is prevented: see -Inhibit erase-) and 
change of main unit; Initializations associated with entering a 
main unit are performed 

jump UNIT NAME 

goto causes execution of the unit named In the tag without a screen erase, 
without change of main unit, and without other main-unit 
Initializations; there Is no further execution of commands In the 
original unit except during the judging process 

goto UNIT NA>IE 
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do (Insertion) causes execution of the unit named In the tag without 

screen erase or change of main unit; returns to the original unit 
to execute commands following -do- 

(Iteratlon) causes repeated execution of unlt(s) named In the tag while 
changing a counter; otherwise same as Insertion -do- 
do UNIT NAME 

do NAME, VAR4= INITIAL EXPR, FINAL EXPR, STEPSIZE EXPR (opt) 

(STEPS IZE, if omitted, is +1; STEPSIZE may be negative; 
loop variable is undefined after completion of the loop) 

Note: Nested -do- and -join- levels may be up to 10 deep. 

Aw iL-i 
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join similar to -do- but is executed during judging and during search 
for additional -arrow- commands following an "ok" judgment 

join UNIT NAME 

join NAME, VAR<= INITIAL EXPR, FINAL EXPR, STEPSIZE EXPR (opt) 

return returns values to variables specified in a -unit- command with 
arguments 

return EXPR 1, EXPR 2, EXPR 3 (maximum of 10 arguments) 
Note: -return- occurs in a unit executed via -do- or -join-, 
do NAME (EXPR ; VARl , VAR2) 

B 

unit NAME(VAR) 

return EXPR1,EXPR2 (r&tvxna values to VARl, VAR2) 

exit permits termination of -do- or -join- sequences 

exit (B) or exit NEGATIVE VALUE (exit from all levels 

of -join- and -do-) 

exit EXPR GIVING NUM LEVELS 
exit 0 (causes no exit) 



iferror specifies the unit to execute via a -goto- if an error is found 
in the execution of a subsequent calculation in a unit 

iferror UNIT NAME 

iferror (B) £r iferror q (turns off -iferror- setting for 

remainder of unit) 
iferror EXPR,NAMEM,NAME0,q,NAME2,x (example of conditional form; 
maximum of 100 arguments in conditional tag) 



imain specifies the unit to execute at the start of every main unit in the 
lesson; later occurrence of the command overrides an earlier setting; 
equivalent to -do- at tho beginning of each main unit 



imain 
imain 

imain 



UNIT NAME 
(B) or imain 



q (turns off -imain- setting for 

remainder of lesson or until reset) 
EXPR,NAMEM,NAME0,q,NAME2,x (example of conditional form; 
maximum of 100 arguments in conditional tag) 
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NOTE: The following two directives (-branch-, -doto-) are calc-type 

directives which permit branching or looping within a unit^ When the 
directive is in the command field, it behaves like a -calc- command. 
In the tag field, the directive is part of a continued -calc-. In 
both cases commands which do not perform calculations are permitted 
within the -branch- or -doto- loop. 

branch permits branching within a unit (the statement label must start 
with a number and may contain up to 7 characters) 

for example: 

5a VAR<= EXPR 



branch EXPR, 5a, x (argument x causes fall-through to the next 

line in the unit) 

calc VAR^ EXPR 
6test VAR<= EXPR 

branch 6test 

branch x (causes fall-through to next line in the -calc-) 
branch EXPR,x,6test (example of conditional form) 



doto permits looping within a unit (the statement label must start with 

a number, may contain up to 7 characters, and must have a blank tag) 

for example: 

doto 2sync,VAR<: INITIAL EXPR, FINAL EXPR, STEPS IZE EXPR 
• 

2sync (B) 



calc VAR«= EXPR 

doto 4run,VAR<: INITIAL EXPR, FINAL EXPR, STEPSIZE EXPR 



4 run (B) 

Note: Stepslze, if omitted, is +!• Stepslze may be negative. 

Value of the loop variable is undefined after completion 
of the loop. 



10 ^ 
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NOTE: The following four commands (-if-, -elseif-, -else-, and -endif-) 

permit branching within a unit. Logical value of an expression is "true 
if its rounded value is -1 and "false" if its rounded value is 0. 



If 



performs a branch based on the logical value of the tag expression; 
value of true" causes fall-through to the next line; value of "false" 
causes branch to the next -elseif-. -else-, or -endif- at the same 
level; code following -if- nrnst be indented (up to the next -elseif-, 
-else-, or -endif- at the same level) and marked with the indent 
symbol; range of -if- must be terminated by -endif- at the same level 



if 



LOGICAL EXPR 



elseif provides an alternative anch within the range of the preceding 
-if- at the same level; subsequent code follows same indenting 
rules as -if- ^ 

elseif LOGICAL EXPR 



else 



(no tag) provides a branch if the logical value of the tag of the 
preceding -if- or -elseif- at the same level is "false"; subsequent 
code follows same indenting rules as -if- 



endif 



(no tag) marks the end of the range of the preceding -if- at the 
same level 



NOTE: 



Following is an example demonstrating placement of these commands, 
if 



Iseif 



Ise 



endif 



n8<4 




write 


first branch 


calc 


n9<= 34 


n8=4 




write 


second branch 


do 


someunit 


write 


default branch 


if 


n8>6 


• 


write special 


endif 





$$ executed if n8<4 
$$ executed if n8<4 
$$ executed if n8^^ 
$$ executed if n8=4 
$$ executed if n8=4 
$$ executed if n8>4 
$$ executed if n8>4 
$$ executed If n8>4 
$$ executed if n8>6 
$$ end of range of -if 
$$ end of range of -if 



n8>6- 
n8<4- 
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NOTE: The following four commands (-loop-, -endloop-, -outloop-, and -reloop-) 
permit looping within a unit. Logical value of an expression is true 
if Its rounded value is -1 and "false" if its rounded value is 0. 

loop initiates a loop based on the logical value of the tag expression; 

value of "true" causes execution of subsequent commands in the loop; 
value of "false" causes execution of the first command after -endloop- 
at the same level of indentation as -loop-; code following -loop- must 
be indented (up to the next -outloop-, -reloop-, or -endloop- at the 
same level) and marked with the indent symbol; range of -loop- is 
marked by -endloop- at the same level 

loop LOGICAL EXPR (blank tag is equivalent to "true" value) 

endloop (no tag) marks the end of a loop initiated by the previous -loop- 
command at the same level of indentation; causes a branch back to 
the previous -loop- command at the same level 

outloop based on the logical value of the' tag, causes exit from the range of 
-loop- at the same level of indentation; value of true causes 
execution of the first command after -endloop- at the same level; 
value of "false" causes execution of subsequent commands within the 
loop, which follow the same indenting rules as -loop- 

outloop LOGICAL EXPR (blank tag is equivalent to "true" value) 

reloop based on the logical value of the tag expression, causes branch back 
to the previous -loop- command at the same level of indentation 
without terminating the loop; value of "true" causes branch to the 
previous -loop- at the same level; value of "false" causes execution 
of subsequent commands within the loop, which follow the same 
indenting rules as -loop- 

reloop LOGICAL EXPR (blank tag is equivalent to "true" value) 

Note: Following is an example demonstrating placement of these commands. 

loop n8<l{) 

write within loop $$ executed if n8<10 

subl n8 $$ executed if n8<l{) 

reloop n8>5 $$ executed if n8<10 

write still within loop $$ executed if n8<5 

do , someunit $$ executed if n8<5 

outloop n8<3 $$. executed if n8<5 

write still within loop $$ executed if 3:$n8<5 

endloop o i « 01 

write outside of loop $$ executed if n8>10 or n8<J 
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Key-initiated sequencing 



NOTE: The following commands (-next- through -lablop-) may have the 

conditional form, where argument x leaves the pointer unchanged, and 
argument q clears the pointer and renders the key inactive (except for 
NEXT, which causes fall-through to the following unit). Argument q is 
not valid with -nextnow-. Up to 100 arguments are permitted in the 
conditional tag. The conditional expression is evaluated when the 
command is executed, not when the key is pressed. 

next, nextl, back, backl, stop specifies the unit executed when the student 
presses the appropriate key (arrows must be satisfied before 
sequencing on the NEXT key) 

next UNIT NAME 
backl . UNIT NAME 

back (B) or_ back q (clears back pointer; disables BACK key) 



nextnow terminates processing in the unit and makes only NEXT key active 
nextnow UNIT NAME 



nextop, nextlop, backop, backlop specifies the unit executed when the 

student presses the appropriate key; there is vio full-screen erase 
and new information is plotted on-the-page; the unit specified, 
however, is a main unit 

nextlop UNIT .NAME 

backop (B) or^ backop q (clears back pointer; disables BACK key) 



help» helpl> data, datal, lab, labl initiates a help-type sequence by 
specifying the unit to be executed if the student presses the 
appropriate key; sets the base pointer for the unit to return to 
unless the base pointer is already set; the unit executed is a 
^ain unit hut not a base unit (unless the base pointer Is reSet 
to this unit); a help- type sequence may be terminated by the 
-end- command 

help UNIT NAME 

lab (B) or^ lab q (clears lab pointer; disables LAB key) 
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helpop, helplop, dataop, datalop, Labop, lablop specifies the unit executed 
when the student presses the appropriate key; the unit executed is 
not a main unit or a base unit and no full-screen erase is performed; 
control is returned to the main unit after execution of the 
helpop-type unit 

helpop UNIT NAME 

dataop (B) or dataop q (clears data pointer; disables DATA key) 



term permits use of the TERM key to initiate a help-type sequence starting 
at the unit containing this command and the specified character 
string; sequence can be terminated by -end- (see -inhibit term-) 

term STRING (maximum of 8 characters) 

term (B) (provides match to any term request that does not 

match an author-specified or system-specified term) 



termop similar to -term- except initiates a helpop-type sequence 
termop STRING (maximum of 8 characters) 

termop (B) (provides match to any term request that does not 

match an author-specified or system-specified term) 



NOTE: A lesson may have up to 299 -term- and -termop- commands • 

base resets or clears the base pointer in order to alter help-type 
sequencing 

base (B) or^ base q (clears base pointer) 

base UNIT NAME (sets base pointer to named unit) 

base EXPR,q,NAME,x (example of conditional form; 

argument x leaves base pointer unchanged; argument q 
clears base pointer; maximum of 10(3 arguments in 
conditional tag) 



end terminates a help-type sequence or a lesson 

end (B) ot_ end help (ends a help-type sequence; may 

occur anywhere in a unit; student is returned to the 
base unit aifter pressing NEXT; -end- is ignored in a 
non-help-type sequence) 

end lesson (when NEXT is pressed after execution of this 

statement, the student is returned to the router lesson 
or to the "Press NEXT to Begin" page; finish unit is not 
executed; authors are returned to the author-mode page) 
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Timing 



keylist (non-executable) forms a set of keys with the specified name for use 
with -pause- and -keytype- commands 



keylist NAME, KEY 1, KEY2, KEY3, 
keylist NAME,NA14E1,NAI-1E2, . 



(from 2 to 7 characters in NAME) 
(keylists may be combined) 



Note: System-defined keylists are: 

alpha (letters: a to 2 and A to Z) 

numeric (digits: 0 to 9) 

funct (function keys ["key" from o200 to o235]) 

keyset (any keyset input) 

touch (input from touch panel) 

ext (input from external device other than touch panel) 

all (input from keyset, touch-panel, or external device) 



pause delays execution of subsequent commands by the specified interval 
or until the specified keys are pressed 



pause 
pause 
pause 

pause 



pause 



Note: 



EXPR GIVING NUM SECONDS (minimum of .15 second) 

0 (causes no pause; exception to .15 second minimum) 

(B) or pause NEGATIVE VALUE (interrupts processing 

until any keypress comes in) 
keys=KEYl,KEY2, KEYLIST NAME,... (interrupts processing 

until one of the specified keys comes in; all keynames 

are typed without quote marks and function keys are 

typed in lower case) 
NUM SECONDS, keys=KEYl,KEY2, KEYLIST NAME,... (interrupts 

processing for the specified time or until one of the 

specified keys comes in) 

If a function key other than next, such as help, is specified 
and there is a preceding -help- or -helpop- command specifying 
a unit to execute, this unit is executed rather than the 
command following the -pause-. If next is specified, the NEXT 
key just breaks the -pause-, even if there is a preceding 
-next- command . 

The statements -pause keys-touch- and -pause keys-ext- set 
the appropriate -enable-. 



collect allows storage of keycodes from keyset, touch panel, or external 

inputs in successive variables, starting at the specified variable; 
collection terminates with receipt of the specified number of keys 
or with receipt of the TIMEUP key, which is also stored 

collect STARTING VAR,NUM KEYS (must use student variables) 
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getcode stores a user-generated string, left-justified, in the specified 
variable and plots X's; "endkeys" specifies function keys which 
terminate the entry (in addition to NEXT, which is the default); 
up to 10 characters may be entered and stored 

getcode VAR, endkeys=KEYNAMEl, KEYNAME 2, . (opt) (names of keys are 

in lower case) 



keytype sets a variable according to the position in a list of the input by 

the user; if the input action is not listed, the variable is set to -1 

keytype VAR, ARG0,ARG1,ARG2, . . . 

arguments ARG0, ARGl, ARG2,... may be any of the following: 

KEYNAME (any keyname; no quotation marks are used; 

function keys are in lower case) 
KEYLIST NAME (name of a system-defined keylist or of a list set up by 

the -keylist- command) 
(VAR) (value of "key" is compared with the value stored in VAR) 

ext(VAR) (when the 10th bit from the right of "key" equals 1, 

indicating an external input, the right-most 9 bits 
of "key" are compared with the value stored in VAR) 
touch (COARSE, WIDTH IN CHARACTERS, HEIGHT IN LINES) 
touch (FINEX,FINEY, WIDTH IN DOTS, HEIGHT IN DOTS) 

(COARSE or FINEX,FINEY is the screen position of the lower left 
corner of a rectangle with specified width and height; width 
and height are optional and are assumed to be 1 if omitted) 

Note: Up to 100 k^ys may be specified; keylists count as one key. 



time presses the TIMEUP key after the specified interval and sets "key*' to 
"timeup"; function keys can break through the timing and set "key" to 
the key pressed 

time EXPR GIVING NUM SECONDS (minimum of .75 second) 

time (B) or time NEGATIVE VALUE (clears any -time- in effect) 



timel specifies a unit in the same lesson to execute (via helpop-type 
sequence) when the indicated time has elapsed; remains In effect 
across other timing commands and across unit boundaries 

timel NUM SECONDS, UNIT NAME (minimum of .75 second) 

timel (B) or timel NEGATIVE VALUE (clears any -timel- in effect) 



timer used in a router lesson to specify a unit in the router to which a 
routed student is sent when the indicated time has elapsed 

timer NUM SECONDS, UNIT NAME (minimum of 60 seconds) 

timer (B) or^ timer NEGATIVE VALUE (clears any -timer- in effect) 
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su 



press puts the specified key into the student input buffer for the 

indicated station, if given; limited to one keypress per second 

press KEYCODE 

press VAR CONTAINING KEYCODE 

press "KEYNAME" (for non-function keys; lower case only) 
press KEYNAME (for function keys, e.g., -press next-) 

press KEYCODE, STATION (presses the key at another station if the 
station is in the same lesson as the -press- command) 

Note: For 2-argument -press-: 

zreturn = -1 if the station is in the lesson 
= 0 otherwise 



catchup (no tag) causes a pause in execution while transmission of 
accumulated output to the terminal is completed in order to 
synchronize display and execution of commands 



break (no tag) interrupts processing and returns with a new timeslice 
for further processing when a complete timeslice is available 



cpulim specifies the maximum CPU usage rate in thousand instructions per 
second with a maximum of 10 thousand instructions per second 

cpulim EXPR GIVING MAXIMUM CPU USAGE RATE (maximum of 10) 
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Lesson connections and sections 



use (non-executable) inserts into the file being condensed the specified 

block(s) from the file specified in the directory OR the file 
specified in the tag of -use-; all contiguous blocks with the same 
name are taken; use codewords on the files must match 

use BLOCK NAME (file is specified in the directory) 
use FILE NAME, BLOCK NAME (multi-file use flag is set in the 
directory; up to 5 different files may be used) 
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jumpout causes execution of the specified lesson or of the processor lesson, 
if one is declared; up to 10 arguments may be passed to the lesson 
(see -inhibit jumpchk-, -inhibit from-, and -args-) 

jumpout FILE NAME (goes to the first unit in the lesson; 

jumpout codewords need not match) 
jumpout FILE NAME(VALUE1, VALUE2) (example of form with arguments) 
jumpout FILE NAME, UNIT NAME (goes to the specified unit in the 

lesson; jumpout codewords must match) 
jumpout FILE NAME, UNIT NAME (VALUE) (example of form with arguments) 
jumpout return (returns to the first unit of the lesson from which 

a jumpout was made to the present lesson) 
jumpout return, return (returns to the lesson from which a jumpout 

was made to the unit following the unit with the -jumpout-) 
jumpout (B) or jumpout q (causes a jumpout to the author-mode page 

for authors or to "Press NEXT to begin" page or to a router 

for students or instructors; similar to -end lesson-) 
jumpout <LESLIST POSITION> (causes a jumpout to the first unit of 

the lesson at the specified position in the leslist) 
jumpout <LESLIST POSITION>,UNIT HAME (causes a jumpout to the 

specified unit in the lesson at the specified leslist 

position; jumpout codewords must match) 
jumpout EXPR;FILEM,UNITM;FILE0;FILEl,UNITl;q;x (example of 

conditional form; argument q causes jumpout as above; 

argument x causes no jumpout) 
jumpout resume (used in a router lesson to return the user to the 

lesson and unit specified by the last -restart-) 
jumpout continue (used in a site lesson to send the user to a 

router or lesson) 

jampout NOTESFILE NAME (causes jumpout to the specified notes file; 

return to lesson is automatic, via -jumpout return, return-) 
jumpout NOTESFILE NAME, datetime (causes jumpout to the specified 

notes file with date and time set in n2 and n3, respectively) 
jumpout notes, choice (causes jumpout with read and write access to 

the student notes file attached to the user's group) 
jumpout notes, read (causes jumpout with read access to the student 

notes file attached to the user's group) 
jumpout notes, write (causes jumpout with write access to the student 

notes file attached to the user's group) 
jumpout notes, instruct (causes jumpout with read access as an 

instructor to the student notes file attached to the group) 
jumpout pnotes (causes jumpout to personal notes) 

Note: Variable lesson and unit names must be enclosed in parentheses. 
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args stores the values of arguments passed by -jumpout- to the lesson; 
values are stored in the specified variables 

args VARl, VAR2,VAR3 (maximum of 10 variables) 

Note: zreturn = -1 if arguments are passed successfully 
= 0 if no jumpout arguments are present 
> 1 if there are more jumpout arguments present than 
variables in -args-; as many values as can be 
received are stored; "zreturn" value is the 
actual number of arguments present 

Arguments passed by -jumpout- may be picked up by a -unit- 
command with arguments instead of by -args-. 



from checKs the lesson and main unit, if specified, from which a lesson is 
entered against a list and sets a variable to the relative position 
of the lesson and unit in the list; if no unit is specified, any unit 
in the lesson qualifies; if the lesson (and unit) are not listed, the 
variable is set to -1; alternate form stores lesson name and unit name 
in the specified variables 

for example: 

from VAR;LESSON0,UNIT0;LESSON1;<LESLIST P0SITI0N>,UNIT2 

(variable lesson and unit names must be enclosed in 
parentheses) 

from VAR FOR LESSON NAME,VAR FOR UNIT NAME (opt) 

lessin checks if the lesson specified is credited to the user's logical site; 

sets "zreturn" to -1 if the lesson is in ECS and in use at the user's 
logical site and to 0 otherwise 

lessin 'LESSON NAME' 

lessin (VAR CONTAINING LESSON NAME) 

lessin <LESLIST POSITION OF LESSON> 



in sets "zreturn" to indicate whether a user at the specified station 

number is in the lesson containing the -in- command 

in EXPR GIVING STATION NUMBER 

Note: zreturn = -2 if the -in- command is in a router lesson and a 

routed user at the specified station is in an 
instructional lesson 

= -1 if the station is in the instructional lesson 
containing the -in- command 

= 0 if the station is not in the lasson 
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notes Initiates TERM -comments automatically, or sends the specified text to 
the lesson notes file or student notes file without user interaction; 
the title, if included, must be left-justified, may contain up to 
15 characters, and always requires two variables 

notes STARTING VAR CONTAINING TITLE (opt) (initiates TERM-comments) 
notes STARTING VAR CONTAINING TEXr,NUM VARS, STARTING VAR 

CONTAINING TITLE (opt) (inserts text at front of note) 
notes STARTING VAR CONTAINING TEXT,NUM VARS, STARTING VAR 

CONTAINING TITLE (opt), send (sends the text automatically) 



Note: Student variables must be used for the text and the title; 
the format for the text is that for -text- command. 
After multi-argument -notes-, values of "zreturn" are: 



zreturn = 



-1 

0 
1 
2 



= 3 



if the note is sent successfully 

if the user pressed BACKl and note was not sent 

if TERM-comments is not allowed in the lesson 

if the format of the text is incorrect or if the 

text is too long (>111 60-bit words or >16 lines) 
if the note cannot be stored (e.g., the notes file 
does not exist or is full) 



cstart (non-executable) (no tag) indicates subsequent code is to be 
condensed (used after a preceding -estop-) 



estop (non-executable) (no tag) indicates subsequent code is not to 
be condensed; in effect up to the next -cstart-, if any 



estop* (non-executable) (no tag) indicates none of the subsequent code 
is to be condensed, independent of subsequent -cstart- commands 



NOTE: It is preferable to use the partial condense option of the editor 
rather than -cstart-, -estop-, and -estop*-. 
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Lesson lists 



leslist references special blocks containing a list of up to 2400 lessons 

(numbered starting at 0); if the -leslist- command and leslist blocks 
are in different lessons, the common codewords must match or the 
codeword argument must be included; codex<?ord argument must match the 
common codeword of the lesson containing the leslist blocks 

leslist (0), LESLIST NAME 
leslist (zlesson) , LESLIST NAME 
leslist , LESLIST NAME 
leslist LESLIST NAME 

leslist LESSON NAME, LESLIST NAME, 'CODEWORD' (opt) 

(LESSON NAME contains the If.slist blocks) 
leslist <LESLIST PCS ITION>, LESLIST NAM.?, 'CODEWORD' (opt) 
leslist (B) (disconnects the current leslist) 

Note: Variable arguments must be enclosed in parentheses. Quote 
marks on the codeword are omitted for variable argument. 

zreturn = -1 if the ^leslist- command is executed successfully 
= 0 if the leslist blocks are not found 
= +1 if codewords do not match 



addlst allows addition of a lesson name to a leslist, either in the specified 
slot or in the first empty slot if none is specified; the tag must be 
a variable; requires three consecutive variables (the name is stored 
with: -storea STARTING VAR, 30-) 

addlst STARTING VAR, LESLIST POSITION (opt) 

Note: zreturn = -1 if the lesson name is added successfully 

= 0 if there is no preceding successful -leslist- 
command 

= 1 if the form of the lesson name is incorrect 
= 2 if the lesson name is already in the leslist 

(with one-argument form only) 
« 3 if the leslist is full 

= 4 if the specified slot is occupied (with two- 
argument form only) 
= 5 if the leslist is reserved by another user 



removl allows deletion of a lesson at a specified leslist position; the 
vacated position is left blank 

removl LESLIST POSITION 



Note: zreturn » -1 if the lesson is removed successfully 

« 0 if there is no preceding successful -leslist- 
command 

« +r if the leslist is reserved by another user 
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reserve reserves the current lesllst to prevent changes via -addlst- and 
-removl- by more than one user at a time 

reserve leslist 

Note: zreturn = -2 if the leslist is already reserved by this user 
= -1 if -reserve- is executed successfully by this 
user 

= 0 if there is no preceding successful -leslist- 
command 

= 5+n, where n=station number of the user who has 
reserved the leslist 



release releases the current leslist (if previously reserved) 
release leslist 

Note: zreturn = -2 if the leslist is not reserved by any user 

= -1 if -release- is executed successfully by this 
user 

= 0 if there is no preceding successful -leslist- 
command 

= 5+n, where n=station number of the user who has 
reserved the leslist 



Iname stores the lesson name at the specified leslist position in 

three consecutive variables starting at the specified variable 

Iname STARTING VAR, LESLIST POSITION 

Note: Use with -showa- to display the lesson name; e.g.: 
Iname STARTING VA.R, LESLIST POSITION 
showa STARTING VAR, 30 

zreturn = -1 if execution is successful 

« 0 if there is no preceding sucessful -leslist- 
command 



findl searches the leslist for the lesson name stored in three 

consecutive variables and returns the leslist position in the 
specified variable 

findl STARTING VAR FOR LESSON NAME, VAR FOR LESLIST POSITION 

Note: If the lesson name is not found or if no leslist is used, 
returned value for the leslist position is -1. 
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Lesson annotation and debugging 



* indicates the statement on that line is a comment only and is to 

c (space) be ignored by the computer 

*This is a comment, 
c This Is a comment. 



$$ (not a command) when placed on the same line with a TUTOR statement 

indicates that subsequent material on that line is a comment 

COMMAND TAG $$this Is a comment 

change (non-executable) permits names of commands to be changed, e.g., 
to a language other than English; also permits symbols (e.g., 
punctuation) to be redefined in certain judging commands; 
-change- must be placed in the initial entry unit; all changes 
are in effect for the entire lesson and cannot be altered 

change command NORMAL TUTOR NAME"^to NEW NAME 
change symbol SYMBOLl to SYMB0L2 

for example: 

change command at to wo 
change symbol * to letter 
change symbol ? to puncword 
change symbol p to punc 
change symbol 3 to vowel 
change symbol a to b 
change symbol space to letter 
change symbol sup to null 
change symbol / to diacrit 
etc . 

Note: The answer-matching commands affected by -change symbol- are: 
-answer-, -wrong-, -answerc-, -wrongc-, -concept-, -miscon-, 
-match-, -storen-. Other commands affected are: -getword-, 
-getmark-, -getloc-, and -compare-. 

step allows a user to step through a lesson command by command; an author 

whose security code matches the lesson's change code may us« TERM-step 
(TERM-step* is not available for other user types) 

step on 
step off 

step EXPR (value»0 turns off step; valueT^0 turns on step) 
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*list (does not affect condensing or execution) specifies options for 

printing a file; -*list- commands for printing special types of blocks 
must precede those blocks in the program; source blocks and text 
blocks are always printed unless specified otherwise 



*list binary, BLOCK NAME,NUM WORDS, FORMAT (prints contents of 

binary blocks; see page S20 for information on FORMAT) 
*list charset (prints contents of all charsets in the lesson 

with 0 for dots on and - for dots off) 
*list charset, (DOTSBLANKS) (prints contents of charsets with 

symbols specified for dots and blanks) 
*list commands, COMMAND 1, COMMAND 2, COMMAND 3,... (up to 10 commands; 

lists lines on print where specified commands appear) 
*list common, COMMON NAME,NUM WORDS, FORMAT (prints contents of 

common; see page S20 for information on FORMAT) 
*list deleted (prints deleted lines [with "mod words" option]) 
*list eject (causes page eject where command is located) 

*list ignore (causes subsequent -*list- commands to be ignored) 
*list info (prints lesson information display) 

*list label, YOUR LABEL INCLUDING SPACES (prints a label at 

the location of the -*list- command) 
*list leslist (prints the contents of all leslists in the lesson) 
*list listing (prints the contents of listing blocks) 
*list micro (prints the contents of all microtables in the lesson) 
*list mods (prints "mod words": first 5 characters of the name of 

the last person to change each line and date of the change) 
*list nosource (stops printing source blocks but not text blocks) 
*list notext (stops printing text blocks but not source blocks) 

*list off (stops printing blocks at the location of the command; 

starts printing preceding -*list-- options and the unit 

cross-reference table) 
*list off ,BLOCKNAMEl,BLOCKNAME2,BLOCKNAME3-BLOCKNAME4 

(specifies blocks that are not to be printed) 
*list parts (prints only source blocks which are set to condense) 
*list symbols (prints reference table of variables, defined 

and primitive, used in the lesson) 
*list text (prints only text of -write- and -writec- commands) 

*list title, YOUR TITLE (specifies subheading to be printed under 

the lesson name on each subsequent page; causes page eject 

when -*list title- is encountered) 
*li8t vocab (prints contents of vocab blocks) 

*list xref,on (turns on unit cross referencing [and symbol cross 
referencing if requested] for all printed source blocks; 
default case) 

*list xref,all (same as -*list xref,on-) y 
*list xrefjoff (turns off cross referencing for all printed source 
blocks) 

*list xref, parts (turns on unit cross referencing [and symbol cross 
referencing if requested] for all printed source blocks 
which are set to condense) 
*list 1 space (prints blocks with single spacing; default case) 
*list 2 space (prints blocks with double spacing) 
*list 3 space (prints blocks with triple spacing) 
*list 4 space (prints blocks with quadruple spacing) 
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Instructions for printing datasets and namesets are specified in the directory 
of the file* Page S20 has information on FORMAT. 



datasets : 



STARTING RECORD NUMBER, NUM RECORD S,FORI^T 

STARTING RECORD, , special 

PAGE EJECTS; STARTING RECORD, , special 

PAGE EJECTS ;special (prints entire dataset in special format with page 

ejects as specified) 
special (prints entire dataset in special format) 

STARTING RECORD, , direct 
PAGE EJECTS 'STARTING RECORD, , direct 

PAGE EJECTS ;direct (prints entire dataset in direct format with page 

ejects as specified) 
direct (prints entire dataset in direct format) 

INSTRUCTION! ;INSTRUCTI0N2; etc. (may state several different instructions) 



namesets : 

NAMES ;STARTING RECORD NUMBER, NUM RECORDS , FORMAT 

NAMES ;STARTING. RECORD, , special 

NAMES ;PAGE EJECTS ; STARTING RECORD, , special 

NAMES ;PAGE EJECTS ;special (prints all records of specified names in 

special format with specified page ejects) 

NAMES ;special 

NAMES ;STARTING RECORD, , direct 

NAMES ;PAGE EJECTS ; STARTING RECORD, , direct 

NAMES ;PAGE EJECTS ;direct 

NAMES ;direct 

INSTRUCTION! ;INSTRUCTI0N2; etc* (may state several different instructions) 



NOTE: PAGE EJECTS may be: pages and/or records (if both are given, the 
entries must be separated by a semicolon, e*g*, pages;records) • 



With namesets, NAMES may be: 



NA14E! 

NAME! -NAME 2 
NAME!- 
-NAME2 
omitted 



(prints records only for NAME!) 

(prints records for names from NAME! to NAME2) 

(prints records from NAME! to the last name) 

(prints records from the first name to NAME2) 

(prints records for all names in the nameset; preceding 

semicolon must be included, e*g*, ;special or 

;STARTING RECORD, , direct) 
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integer 


or 


i 


exponential 


or 


e 


floating 


or 


f 


octal 


or 


o 


hexadecimal 


or 


h 


alpha 


or 


a 


X 






special 


or 


s 



Note: FORMAT for printing datasets, namesets, commons, and binary blocks: 

(nc-variables; prints 10 words per line) 
(vc-variables ; prints 10 words per line) 
(vc-variables; prints 10 words per line) 
(prints 5 words per line) 
(prints 6 words per line) 
(prints 10 words per line) 

(prints each word in o, e, i, and a formats; 
prints 2 words per line) 

(special format; specified number of words to be 
printed is ignored but field must be present; 
details below) (not used with binary blocks) ' 
direct or d (like special format but carriage control is required) 

(DESIGNED) (designed format; enclosed in parentheses; details below) 

special format and direct format: 

words are interpreted in alpha; 

words with all 0 bits are ignored unless they are preceded by at least 

one non-zero word on the same line; 
a line (and a page) must always end id.th at least 12 zero bits (o0000) 
up to 127 characters may be printed per line; 

control characters for direct: " single space; "0", double space; 

triple space; overwrite; "1", page eject; "2", bottom of page 

the following print options are placed directly in the dataset, 
nameset, or common; each requires two consecutive words: 

*format eject (signals page eject at this location) 

*format end (indicates the print of the file or of the name is 

to end at this location) 
*format pages (signals page eject after each printed page; 

allows top and bottom margins) 
*format records (signals page eject after each subsequent record) 
*format blocks (signals page eject after each subsequent block) 

designed format: 

the format is for a line of print; 

format must be enclosed in parentheses; 

up to 135 characters may be printed per line 

designed format may consist of: 

i (integer; nc-variables ; prints 10 characters per word) 

e (exponential; vc-variables ; prints 10 characters per word) 

f (floating point; vc-variables; prints 10 characters per word) 

0 (octal; prints 20 characters per word) 

h (hexadecimal; prints 15 characters per word) 

a (alpha; prints 10 characters per word) 

X (space; preceding number indicates number of spaces) 

1 (location of word; prints 4 or more characters) 

p (skip to next word to be printed on the same line; 

preceding number indicates how many words to go forward) 
O commas and spaces for readability 
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args 



backout 



baseu 



clock 



f romnum 



key 



lessnum 



lleslst 



llesson 



mainu 



mallot 



muse 



iables for sequencing 

number of arguments transferred at the previous execution of a unit 
with arguments or -jurapout- with arguments 

« -2 for a single-station backout 
= -1 for a general backout 

« (Zl for no backout (e.g. signoff via STOPl) 
=» +1 after -station stopl- 

narae of the user's current base unit (= 0 if no base unit is 
specified, indicating the user is not in a help-type sequence) 

value of the system clock in seconds (to the nearest millisecond) 
since the previous deadstart (see command -clock-) 

leslist position of the lesson from which the user came via a jumpout 
(= -1 if the lesson is not in the leslist or if no leslist is in use) 

after a keyset input: contains the 7-bit keycode of the last keypress;, 
after a touch-panel input: contains a 9-bit number which gives the 
location of the touch square (the binary form of this number is 
Ixxxxyyyy, where the 4 bits labeled "x" give the horizontal touch 
location and the 4 bits labeled "y" give the vertical touch location — 
coordinates for touch squares on the screen are: 0,0 at lower left, 
0,15 at upper left, 15,0 at lower right, 15,15 at upper right); 
after an external input: contains a 10-bit number whose left-most 
2 bits are 10, with the remaining 8 bits carrying information from 
the external source 



leslist position of the user's current lesson (= -1 if the lesson 
is not in the leslist or if no leslist is being used) 

maximum number of lessons allowed in the leslist (« 0 if no leslist 
is in use) 

condensed length of the lesson 

name of the user's current main unit 



memory allotment for the logical site at which the user is working 
total memory usage by users at the same logical site as the user 
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nhelpop number of times a help-type key is pressed for on-the-page help; 
zeroed for each main unit and for each arrow in the unit 



proctim processing time in the les$on (in seconds, to nearest millisecond) 



ptime » -1 if the current time is during prime-time hours 
= 9 otherwise 



sitenam name of the user's logical site 



station identification number assigned by the system to a terminal 
physical site « station $ars$ 5 » int (station/32) 
site station # = station $mask$ o37 = 32 x f rac(station/32) 
station » 32 x physical site + site station # 



tactive number of currently active terminals 



user user type: 'author' , 'instructor' , 'student' , 'multiple' , 

'sabort' (if student records have been aborted), 'snockpt' (if 
automatic checkpoint has been aborted) 



usersin number of users in the lesson (routed users are counted as being in 
the router as well as in the instructional lesson) 



zaccnam name of the account which contains the user's group 



zcondok = -1 if the lesson condenses without errors or warnings 

= 0 if the lesson has condense errors or warning messages 



zfroml name of the lesson from which a jumpout was done 
zfromu name of the unit from which a jumpout was done 
z group name of the user's group 



zid unique identification number for the user; information is in 3 fields 

(counting from the left end of the word); 
18 bits: system identifier 
22 bits: group identifier 
20 bits: name identifier 
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zlesson name of user's current lesson 



zpnflle = -1 if the user's group has a personal notes file attached 

= 0 otherwise (and for multiples and students without access to 
personal notes) 



zpnotes = -1 if the user has new, unread personal notes 
=» 0 otherwise 



zretrnu name of the unit to which -jumpout return, return- will go 



zreturn 




zsnfile = -1 if student user's group has a student notes file attached 
(TERM-comments sent to student notes file) 

a 0 otherwise (and for authors and instructors) 
(TERM-comments sent to lesson notes file) 

= +1 if access to student notes and lesson notes is not allowed 



zsnotes 



-1 if the student has new, unread notes 
0 otherwise 



zsysid 60-bit value which uniquely represents the user's PLATO system; will 
not change during lifetime of the system; not for display purposes 



zsystem contains the name of the user's PLATO system 



zterm contains the last term requested by the user 



ztouchx fine-grid x-location of the center of the touch box touched 
(= -1 if last input was not a touch input) 



ztouchy fine*-grld y-location of the center of the touch box touched 
(a -1 If last input was not a touch input) 
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ztzone contains the three-letter abbreviation of the time zone of the 

location of the central computer of the user's PLATO system (e.g., CST) 



zunit 



name of the user's current unit 



zusers number of users currently signed on 



NOTE: The following system variables contain alphabetic information 
(left-justified) and must be displayed with -showa-: 

baseu, mainu, sitenam, user, zaccnam, zfroml, zfromu, zgroup, zlesson, 
zretrnu, zsystem, zterm, ztzone, and zunit. 



In addition to the system variables listed in this subsection, keynames of 
function keys may be treated as system constants. These keynames are typed 
in lower case (e.g., next, lab, term) and have the numerical values given in 
the keycode table on page A5. The exception is the SQUARE key, which has the 
keyname "microl". 
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TERMINAL RESIDENT PROCESSING 



Tl 



This section presents commands and system variables available with the PLATO 
Programmable Terminal (PPT) and the CDC Information Systems Terminal (1ST). 
Both types of terminals are referred to as "ppt". Details of assembly language 
are offered in several manuals and are not included here» Features of the 
TUTOR-like programming language (;jTUTOR) and of central system TUTOR for 
running assembly language programs are described* 

The )LxTUTOR language is evolving rapidly, and users should check "aids" for 
current features. 



Loading and running 

I 

^tutor (non-executable) (no tag) marks the beginning of a terminal resident 
program written in ;jTUTOR; all subsequent commands are interpreted 
as ;iTUTOR commands; must follow the TUTOR part of a program 



unit ; similar to the TUTOR -unit- but the contents of the /iTUTOR unit are 
executed inside the terminal and must follow a -ptutor- command; 
form with arguments is not available 

unit NAME (maximum of 8 characters in NAME) 



loadu loads units into the terminal's memory so they can be executed with 
-runu- or referenced by sequencing commands in ^aTUTOR; must be 
placed in the TUTOR portion of a program 

loadu NAME 1, NAME 2, NAME 3 (maximum of 20 units can be loaded) 
loadu ,NAME1,NAME2,NAME3 (loads specified units without deleting 

those already loaded) 
loadu (B) (clears flags indicating units are loaded) 

Note: zreturn = -1 if units are loaded successfully 

» 0 if the terminal is not programmable 

» 1 if there is not enough memory in the terminal 

« 2 if the units cannot be found 

= 3 if STOP or STOPl is pressed during loading 

« 4 if pTUTOR is not available 

=5 if there is a system error 

« 6 if too many units are loaded 

runu causes execution of a unit which was previously loaded into the 

memory of the terminal (with -loadu-); must be placed in the TUTOR 
portion of a program 

runu NAME 

Note: zreturn -1 if the -runu- is executed successfully 
e 0 if the specified unit is not loaded 
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(no tag) terminates execution of the unit which is executing when 
-haltu- is executed; if no unit is running, -haltu- is ignored; the 
^TUTOR unit must contain a -pause- command in order to be halted; 
-haltu- must be placed in the TUTOR portion of a program 
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Calculating 

define (non-executable) similar to TUTOR -define- but primitives (n, v) are 
not used; names of variables, constants, arrays, and functions are 
listed, with the number of bits, if necessary; definitions are 16-blt 
signed Integer type unless type is specified as floating point or 8-bit 
signed integer; all definitions following a specific type designation 
follow that designation until a different designation is encountered 

for example: 

define NAME1,NAME2,NAME3 
NAME4(ARRAYSIZE) 
i,8:NAME5,NAME6 
FUNC (ARC1,ARG2)=EXPR 
f , 4 8 : NAIIE 7 , NAME 8 (ARRAYS IZ E ) 
i,16:NAME9 

1 , 8 : NAME 1 0-NAME 9 , NAME 11 «N AME 9 
NAME12=20,NAME13=4.3 



Note: Defined names may contain up to 7 characters and must start 
with a letter. 

Up to 6 arguments are permitted in defined functions. 
One-dimensional arrays are permitted* 



calc similar to TUTOR -calc- (available functions are listed on page T7) 
calc VAR^ EXPR 

calc VAR<^ "LETTER" (single character only; character code is 
placed in the right-most 8 bits of VAR of Integer type) 



calcc similar to TUTOR -calcc-; the conditional expression must conform to 
^LiTUTOR restrictions on calculations 

calcc EXPR, VAR1<= EXPRM,VAR24» EXPR0,VAR3<= EXPRl, ,VAR4<= EXPR3 



calcs similar to TUTOR -calcs-; the conditional expression must conform to 
pTUTOR restrictions on calculations 

calcs EXPR,VAR<»EXPRM,EXPR0,EXPRl,EXPR2,,EXPR4 



zero sets to zero a single variable or consecutive variables 
zero VAR 

zero STARTING VAR,NUM VARS 

zero (B) (sets all defined variables to 0) 

In the 2-argument form, the number of bits zeroed is determined 
by the type designation of STARTING VAR. 
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set sete values of consecutive variables starting at the specified 

variable, or sets values of consecutive array elements starting at 
the specified element 

set STARTING VAR<5= EXPRl,EXPR2,EXPR3, . . . 



compute evaluates a character string containing a simple expression involving 
constants and converts the string to a number 

compute VAR FOR RESULT, STARTING VAR OF STRING, NUM CHARACTERS 

Note: zreturn = -1 if the string is converted successfully 

= 1 if the string contains an invalid character 

« 2 if there too many decimal points 

« 3 if the expression is too complicated 

» 4 if there is an unrecognized operator 

« 5 if the expression has bad form 

» 6 if there are unbalanced parentheses 

randu selects a random number, sampled with replacement, and places it in 
the specified variable 

randu VAR, MAXIMUM (selects integer from 1 to MAXIMUM; 

0 < MAXIMUM < (2^5.1) ) 

Note: If the number generated is larger than the specified variable 
type can store, only the right-most bits are retained. 

setperm creates a permutation list of the specified length for sampling by 

the -randp- command (similar to the two-argument -setperm- in TUTOR) 

setperm LIST LENGTH, STARTING VAR OF LIST (first variable of the list 
contains the number of Integers remaining in the list; each 
remaining variable contains one bit for each integer) 

randp selects an integer from the list set up by -setperm- and places it in 
the specified variable; when the list is exhausted, the variable is 
set to 0 

randp VAR FOR STORING VALUE, STARTING VAR OF PERMUTATION LIST 

remove removes the specified value from the permutation list 

remove INTEGER TO REMOVE, STARTING VAR OF PERMUTATION LIST 

restore restores the specified value to the permutation list 

restore INTEGER TO RESTORE, STARTING VAR OF PERMUTATION LIST 
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block copies consecutive variables from one location to another (similar to 

the TUTOR form of -block- except that there are no central memory 
variables) 

block FROM STARTING VAR,TO STARTING VAR,NUM VARS 

Note: The number of 8-bit bytes copied is determined by the type 
designation of the "from" variable. 

find scans each variable in a list of consecutive variables for the first 
occurrence of the specified object 

find ARG1,ARG2,ARG3,ARG4 

ARGl = variable containing the object bit pattern 

ARG2 = starting variable of the list (variables in the list 

must be the same type as the object) 
ARG3 = number of variables in the list 
ARG4 = variable for storing the location of the object 

(0 if found in first variable, 1 if found in second 
variable, etc, -1 if the object is not found) 

pack similar to TUTOR -pack- but packs each 6-bit character code into one 
8-bit byte; string may contain embedded -show- and -showa- 

pack STARTING VAR FOR STORING STRING^VAR FOR STORING 
CHARACTER COUNT (opt)|STRING 

search searches a buffer for the first occurrence of the specified character 
string (each character occupies an 8-bit byte) 

search ARG1,ARG2, ARG3,ARG4,ARG5,ARG6 

ARGl « starting variable containing the object string to be 
searched for 

ARG2 = number of 8-bit bytes in the object string 
ARG3 « starting variable of the buffer to be searched 
ARG4 « number of 8-bit bytes in the buffer to be searched 
ARG5 = relative character position in the buffer at which to 

start the search 
ARG6 « variable for storing the relative location of the object 
(0 if found in the first 8-bit byte, 1 if found in the 
second 8-bit byte, etc., -1 if not found) 
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searches a buffer for the first occurrence of a character string in 
a specific field within an object 

searchf ARGl, ARG2,ARG3,ARG4,ARG5, ARG6, ARG7, ARG8 

ARGl = variable which contains the first character of the 

string to be found 
ARG2 " number of S-bit bytes in the string 
ARG3 « starting variable of the buffer to be searched 
ARG4 " number of entries in the buffer to be searched ^ 
ARG5 « entry in the buffer at which to start searching 
ARG6 « number of S-bit bytes in each entry in the buffer 
ARG7 « starting byte position within each entry for comparison 

with the string 

ARG8 « variable for storing the relative position of the object 
(0 if found in the first entry, 1 if found in the second 
entry, -1 if not found) 
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Operations, symbols, and functions used in calculations 

addition + 
subtraction - 
multiplication x or * 
division ^ or I 

exponentiation ** 

parentheses and brackets ( ), [ ]> { ) 
assignment of a value to a variable ^ 
designation of an octal constant o 

^ « degree sign; indicates a number is interpreted in degrees 
TT « pi « 3.14159... 
e « 2.71828. .. 

bit operations: $mask$, $union$, $diff$, $ars$, $cls$ 
logical operations: <, >, <, >, =, ?^ 



abs(X) absolute value of X 

int(X) integer fart of X 

frac(X) fractional part of X 

log(X) common logarithm of X (base 10) 

alog(X) common antilogarithm of Z (i.e.j 10^) 

ln(X) natural logarithm' of X (base e) 

exp(X) e^ 

sin(X) sine of X, X in radians; use sin(X'') for X in degree's 

co8(X) cosine of X, X in radians; use cos(X'*) for X in degrees 

comp(X) one's complement of X (bit reversal) 

zvloc(X) absolute memory location in RAM of the variable X 



zk(KEYNAME) returns keyset code for KEYNAME (e,g., zk(iii), which has value 77; 

KEYNAME must be specified; expression is not allowed; allowed 
keynames are given in the appendix, in the keycode table for 
programmable terminal) 

Numbers are represented in "two's complement" form; i.e., -X = comp(X)+l • 
Since integers have at most 16 bits and the left-most bit is the sign bit, the 
range of values for integers is -2^^ to +(2^^ - 1), or -32768 to +32767 . 
(The larger range for negative values results from two's complement 
representation. ) 

Floating point numbers contain 48 bits: 1 bit for the sign bit, 15 bits for 
the exponent, and 32 bits for the coefficient. The range of values for 
floating point numbers is 2~16383 2+16383^ 

Numbers have up to 9 significant digits. 
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File operations 



attach establishes a connection between a ^TUTOR lesson and a dataset which 
is stored on a floppy disk which is connected to the terminal 

attach NAME (variable tag must be an integer variable and must be 
enclosed in parentheses) 

Not.a: zreturn = -1 if connection to the file is successful 

= 0 if the dataset is not found on the floppy disk 
= +1 if there is a disk error 



datain transfers data from the dataset to the specified buffer 

datain STARTING RECORD NUMBER, TO STARTING VAR,'NUM RECORDS 

dataout transfers data from the specified buffer to the dataset 

dataout STARTING RECORD NUMBER, FROM STARTING VAR,NUM RECORDS 

NOTElc With -datain- and -dataout-: 

zreturn = -1 if the transfer is successful 
= 0 if no dataset is attached 
= +1 if there is a disk error 

Each record of a ;iTUTOR dataset contains 128 8-bit bytes. With 
-datain- and -dataout-, the receiving or sending buffer must 
accommodate the records received or sent. 
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Judging 



darrow (non-executable) establishes a buffer (starting variable and length) 
for all subsequent -arrow- commands; If omitted, the buffer must be 
specified with the -arrow- command 

darrow STARTING VAR,NUM CHARACTERS ALLOWED 



arrow places an arrow on the screen at the specified location and stores 
characters in the specified buffer; Indented commands which follow 
-arrow- are executed before processing stops to wait for student 
input; non-indented commands which follow these Indented commands but 
which precede response-matching commands are executed each time a 
judging key is pressed to initiate judging 

arrow LOCATION; STARTING VAR,NUM CHARACTERS ALLOWED 
(LOCATION may be COARSE or FINEX,FINEY) 
arrow LOCATION (buffer established by preceding -darrow-) 



endarrow (no tag) must terminate response processing; if the response is 

matched, Indented commands following the matched response and Indented 
commands following -if match- are executed; if the "wrong" response is 
matched or if the response Is not matched, judgment is ''no" and 
processing stops until another response is entered; If judgment is 
"ok", response processing is complete and commands following -endarrow- 
are executed 



long modifies the maximum number of characters allowed at an arrow set by 
the -arrow- command or the -darrow- command; must follow -arrow-; 
cleared at each -arrow- 

long NUM CHARACTERS 

force initiates judging when the number of characters entered reaches the 
limit set by the most recent -long- command executed; must appear as 
an Indented command following -arrow-; cleared at each -arrow- 
force long 

jkey specifies keys (in addition to NEXT) which will initiate judging; must 
follow -arrow-; cleared at each -arrow-; if a non-function key is 
specified, it appears as the last key in the response buffer 

jkey KEY1,KEY2,KEY3 (e.g., jkey back,=,a ) 
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copy activates COPY key and specifies a buffer containing characters to be 
written on the screen one word at a time when COPY is pressed; the 
string is placed in the response buffer; must follow -arrow-; 
cleared at each -arrow- 



copy STARTING VAR.NUM CHARACTERS 



putd replaces a character string in the response buffer with another 

character string; the first character in the tag is interpreted as 
the separator between strings; must follow -arrow-; cleared at each 
-arrow- 



putd /STRING1/STRING2/ (separator is /) 
putd ,STRING1, STRING 2, (separator is ,) 



Note: zreturn = -1 if -putd- is executed successfully 

« 0 if the replacement string cau.^es the response to 
be longer than the storage buffer 



specs modifies standard judging procedures for all subsequent answer 
processing at that arrow; cleared at each -arrow-; settings are 
cumulative at an arrow; must follow -arrow-; cleared at each -arrow- 



specs 
specs 



specs 
specs 
specs 



specs 
specs 



nookno 
ok cap 



okextra 



okspell 



punc 



(B) 



(prevents appearance of "ok" and "no") 
(allows capitalized word in the response to match a 
non-capitalized word in the tag of a response- 
matching command) 

(allows "extra" words in the response, i.e., words 
not in the tag of the response-matching command) 
(allows any reasonable spelling of words in the 
response) 

(allows only punctuation specified in the response- 
matching command; without -specs punc-, specified 
punctuation must be present, but additional 
punctuation may also be present) 
(clears previous settings at this arrow) 



nookno, okcap, okspell (may combine tags) 



NOTE: With the following response-matching commands (-keyword-, -answer-, 
-wrong-, -answerc-, -wrongc-, -exact-, -exactw-, -ansv-, -wrongv-), 
if the response matches the tag or the required argument, subsequent 
indented commands are executed up to the next non-indented command. 



keyword checks the response for words listed in the tag; if a word is matched, 

the variable is set to the relative position of the matched word in 

the tag and judgment is "ok" ("zjudged" set to -1); if no word is 

matched, the variable is set to -1, judgment is not made, and judging 
continues 




keyword VAr{wORD0 {[WORDl SYNONYMl]{wORD2{JwORD4 
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answer compares the response with the -answer- tag; checks for spelling, 

capitalization, extra words, and punctuation unless altered by -specs-; 
punctuation marks are treated as words; sets "zjudged" to -1 if the 
response matches the tag 

answer <EXTRA WORDS > [SYNONYMS SEPARATED BY SPACES] W0RD2 W0RD3 
answer < a, STARTING VAR,NUM CHARACTERS > (maximum of 10 words) 



wrong similar to -answer- but for an incorrect response; sets "z judged" to 0 
if the response matches the tag 

wrong <EXTRA WORDS > [SYNONYMS SEPARATED BY SPACES] W0RD2 W0RD3 
wrong <a,VAR,NUM CHARACTERS > (maximum of 10 words) 



answerc conditional form of -answer-; performs checks available with -answer-; 
sets "zjudged" to -1 if the response matches the required argument 

answerc EXPrJrESPONSEm(rESPONSE0(JrESPONSE2 

wrongc similar to -answerc- but for an incorrect response; sets "zjudged" to 0 
if the response matches the required argument 

wrongc expr}responsem{response0JresponseiJ}response3 



exact compares the response with the tag for an exact character by character 
match; sets "zjudged" to -1 if the response matches the tag 

exact STRING 



exactw similar to -exact- but for an incorrect response; sets "zjudged" to 0 
if the response matches the tag 

exactw STRING 



ansv checks a numerical response against the first argument in the tag, 
with tolerance set by the optional second argument; sets 
"zjudged" to -1 if the response matches the tag within the tolerance; 
tolerance may be stated as absolute deviation or percent deviation; 
if tolerance is omitted, the response value must match the tag value 

ansv VALUE, TOLERANCE (opt) 




wrongv similar to -ansv- but for an incorrect numerical response; sets 

"zjudged" to 0 if the response matches the tag within the tolerance 

wrongv VALUE, TOLERANCE (opt) 
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judges a response "ok" and sets "zjtidged" to -1 if the rounded value 
of the tag Is negative; if the judgment is "ok", indented commands 
following -ok- are executed 

ok EXPR (blank tag is equivalent to negative value) 

judges a response "no" and sets "zjudged" to +1 if the rounded value 
of the tag is negative; if the judgment is "no", indented commands 
following -no- are executed 

no EXPR (blank tag is equivalent to negative value) 

(no tag) placed on the line between response-matching commands to 
provide alternative responses for the same value of "zanscnt"; if any 
tag of commands linked by -or- is matched, indented command following 
the last linked response-matching command are executed 

(no tag) indented commands following -ifmatch- are executed whenever 
a response is matched, independent of judgment ("zjudged" equals -1, 
0, or +1); only one -ifmatch- may occur for each -arrow-; -if match- 
must be the last non-indented command before -endarrow- 



specifies the unit to be executed immediately after each subsequent 
-arrow- in a main unit; equivalent to indented -do- command after the 
-arrow- command; cleared at each main unit; later occurrence in the 
unit overrides an earlier setting in the unit 

i arrow UNIT NAME 

iarrow EXPR,UNITM,UNIT0,X5q,UNIT3 (example of conditional form) 
iarrow q (clears previous setting in the unit) 

specifies the unit to be executed each time the student presses a 
judging key; equivalent to non-indented -do- command after -arrow- 
following indented commands but preceding response-matching commands; 
cleared at each main unit; later occurrence in the unit overrides an 
earlier setting in the unit 

i judge UNIT NAME 

ijudge EXPR,UNITM,UNIT0,q,UNIT2,x (example of conditional form) 
1 judge q (clears previous setting in the unit) 
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judge alters the judgment rendered by judging commands 

judge ok (sets judgment to "ok"; sets "zjudged" to -1; 

processes subsequent regular commands before 
branching to -if match- [or -endarrow-] ) 

judge no (sets judgment to "no" [unanticipated]; sets 

"zjudged" to +1; processes subsequent regular 
commands before branching to -ifmatch- [or 
-endarrow-] ) 

judge wrong (sets judgment to "no" [anticipated] ; sets 

"zjudged" to 0; processes subsequent regular commands 
before branching to -ifmatch- [or -endarrow-] ) 

judge okquit (sets judgment to "ok"; sets "zjudged" to -1; 

does not process subsequent regular commands; 
branches to -ifmatch- [or -endarrow-] ) 

judge noquit (sets judgment to "no"; sets "zjudged" to +1; 

does not process subsequent regular commands; 
branches to -ifmatch- [or -endarrow-] ) 

judge quit (does not alter judgment or "zjudged"; does not 

process subsequent regular commands ; branches to 
-ifmatch- [or -endarrow-] ; allows the student to 
leave the arrow even if judgment is not "ok") 

judge continue (sets "zjudged" to 2; processes indented commands 
and then resumes processing non-indented judging 
commands ) 

judge exdent (sets "zjudged" to 2; does not process subsequent 

indented commands; processes non-indented judging 
commands ) 

judge exit (returns to the arrow to wait for additional input) 

judge ignore (stops processing, erases response, and returns to 

the arrow to wait for additional input) 
judge X (leaves judgment unchanged; used in conditional 

form) 

judge EXPR,no,ok,x,wrong (example of conditional form) 
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getmark used after judging a response to give markup information on 
individual words in the response 

getmark AIIG1,ARG2 

ARGl = relative position of the word in the response 

(first word is 1, second word, 2, etc.) 
ARG2 « variable containing markup information 

= -2 if the response is perfect or if no markup is done 

with the response-matching command used 
« -1 if the position of the word is out of bounds 

(i.e., if ARGl>"zwcount") 
« 0 if there are no errors in the word 
> 0 bits in ARG2 are set according to the error (s), 
starting at the right-most bit (subscript "2" 
indicates the number is in binary notation): 
(I2) a word preceding this word is missing 
(102) the word is out of order (too far right) 
(1002) there is a capitalization error 
(1 0000) the spelling is incorrect 
(10 0009) [bit not currently set] 
(100 0009) the word is an extra word 
(1 000 0002) this word is the last word, and a 

word which should follow is missing 

getloc gives the screen position of the beginning (and end, if requested) of 
the specified word in the response 

getloc ARG1,ARG2,ARG3,ARG4 (opt),ARG5 (opt) 

ARGl » relative position of the word in the response 

(first word is 1, second word, 2, etc.) 
ARG2 variable for storing the finex screen position of 

the beginning of the word (= -1 if ARGl > "wcount") 
ARG3 = variable for storing the finey screen position of 

the beginning of the word 
ARG4 = variable for storing the finex screen position of 

the end of the word (optional) 
ARG5 = variable for storing the finey screen position of 

the end of the word (optional) 
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Presenting 

write displays text, including embedded information 

write MESSAGE, INCLUDING EMBEDDED INFORMATION 



wrltec displays one of several messages, depending on the value of the 

conditional expression; the conditional expression must conform to 
restrictions on calculations 

wi-itec EXPr{mESSAGEm}mESSAGE0}mESSAGE1 {{messages 

NOTE: The fo]** owing embed features are available. See descriptions of the 
individual commands for definitions of the arguments. 

<show,EXPR> or <s,EXPR> 

< showt , EXPR , LEFT , RIGHT > or < t , EXPR , LEFT , RIGHT > 
<showb,EXPR,NUM BITS> or <b,EXPR,NUM BITS> 

< showo, EXPR, NUM PLACES> or <o,EXPR,NUM PLACES> 
<showh,EXPR,NUM PLACES> or <h, EXPR, NUM PLACES> 
<showa, STARTING VAR,COUNT> or <a, STARTING VAR,COUNT> 
<at,COARSE>; < at ,FINEX,FINEY> 

<atnm,COARSE> ; < atnm,FINEX,FINEY> 



show displays the value of an integer variable or expression 
show EXPR 



showt displays the value of a variable or an expression in the specified 
format 

showt EXPR, PLACES LEFT OF DECIMAL, PLACES RIGHT OF DECIMAL 

(format, if omitted, is 4,3; if third argument Is omitted 
no places are shown to the right of the decimal) 



showb displays the value of an integer variable or expression in binary 
notation; displays the specified number of bits, counting from the 
right end of the value 

showb EXPR, NUM BITS 



showo displays the value of an integer variable or expression in octal 

notation; displays the specified number of places, counting from the 
right end of the value 



showo EXPR, NUM PLACES 
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showh displays the value of an integer variable or expression in hexadecimal 
notation; displays the specified number of places, counting from the 
right end of the value 



showh EXPR,NUM PLACES 



showa displays characters in the specified integer variable(8), reading from 
the left end of the buffer; each character is in an 8-bit byte 

showa STARTING VAR,NUM CHARACTERS 



erase erases the screen, selectively or entirely 

erase (B) (causes full-screen erase) 

erase NUM CHARACTERS TO ERASE 

erase NUM CHARACTERS PER LINE, NUM LINES 



mode 



specifies terminal writing mode 



mode write (normal writing state; writes selected dots) 

mode erase (erases selected dots) 

mode rewrite (erases and rewrites in one step) 
mode inverse (displays dark characters on light background) 
mode EXPR, erase, write, X, inverse (example of conditional form; 
argument x leaves writing mode unchanged) 



size specifies size bold-face or normal writing or sets size for -rdraw- 

size SIZE (affects -rdraw- only) 

size bold (specified bold-face writing) 

size (B) (specifies normal writing; default condition) 



rotate specifies vertical or normal writing _or sets angle for -rdraw- 

rotate ANGLE IN DEGREES (affects -rdraw- only) 

rotate vertical (writing plots from bottom to top of screen) 

rotate (B) (writing plots from left to right; default condition) 

text displays contents of an alphanumeric buffer line by line; the end of 

a line must be indicated by an 8-bit byte equal to 0; not affected by 
-size- or -rotate- 



text STARTING VAR,NUM 8-BIT BYTES 
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textn similar to -text- except lines of text are numbered to the left of 
each line; not affected by -size- or -rotate- 

textn ARG1,ARG2,ARG3,ARG4,ARG5,ARG6 

ARGl = starting variable of the buffer 
ARG2 = number of 8-bit bytes 

ARG3 = variable for storing the position of the next character 
to be plotted (1 + position of last character displayed) 

ARG4 = number of the first line displayed (if equal to 0, no 
text is displayed) 

ARG5 = number of the last line displayed (maximum is 31) 

ARG6 = maximum number of characters per line 



charlim (non-executable) specifies the highest character number into which 
alternate font characters may be loaded by -char- or -charset-; if 
omitted, 128 slots are set aside in memory for storing characters 

charlim NUMBER (values from 0 to 127) 

charset loads a character set into the terminal's memory from the floppy disk 
connected to the terminal 

charset LESSON NAME, BLOCK NAME (variable arguments must be enclosed 

in parentheses) 

Note: zreturn = -1 if the charset is loaded successfully 

= 0 if the charset is not found on the floppy disk 
= +1 if an error occurs In reading the floppy disk 



char permits specification of specially designed characters for display 

char NAME, ARGl, ARG2,ARG3,ARG4,ARG5,ARG6,ARG7,ARG8 
char NAME, STARTING VAR 

Note: In the 9-argument form, ARGl through ARG8 specify which of the 
16 dots are lit in each of the 8 columns of the character- In 
the 2-argument form, STARTING VAR is the first of 8 consecutive 
16-bit variables, each specifying the dots in each of the 
8 columns, as in the 9-argument form. 
NAME may be a character number or a defined name- 

getchar copies the depiction of the specified character into the specified 

buffer (8 consecutive 16-bit integer variables or^ 16 consecutive 8-bit 
integer variables); one column of the character is in each 16 bits 

getchar NAME , STARTING VAR 

Note: NAME may be a character number or a defined naiue- 
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inhibit disables certain acti - is of /liTUTOR in a unit; settings are cleared 

at each main unit anc default settings are restored; effect within a 
unit is cumulative, i.e., later occurrence of -inhibit- is added to 
the effect of an earlier occurrence 



inhibit arrow 
inhibit blanks 

inhibit erase 

inhibit keys 
inhibit plato 
inhibit (B) 



(prevents plotting of the response arrow) 

(prevents judging if a judging key is pressed before 

a response is entered; default setting) 

(prevents normal full-screen erase when proceeding to 

a new main unit) 

(prevents any keypress from breaking through -pause-) 
(prevents processing of output from the central system) 
(establishes the default settings in this main unit; 
equivalent to: -allow arrow, erase, keys, plato- and 
-inhibit blanks-) 



allow 



permits actions which have been inhibited in the unit by -inhibit-; 
effect within a unit is cumulative, i.e., later occurrence of -allow- 
is added to the effect of an earlier occurrence 

allow arrow (allows the response arrow to be plotted) 

allow blanks (allows null input at a response arrow; default is 

-inhibit blanks-) 
allow erase (allows a full-screen erase at a new main unit) 
allow keys (allows input from the keyset to break through -pause-) 
allow plato (allows processing of output from the central system) 
allow (B) (establishes settings opposite to default settings; 

equivalent to: -inhibit arrow, erase, keys, plato- and 

-allow blanks-) 



xout sends data (in 8-bit bytes) contained in the specified variables to 
an external device; data is read starting with the left-most byte 

xout DEVICE ADDRESS, STARTING VAR,NUM 8-BIT BYTES TO SEND 



xin collects data (in 8-bit bytes) from an external device and stores it 

in the specified variables; data is stored starting at the left-most 
8-bit byte 

xin DEVICE ADDRESS, STARTING VAR,NUM 8-BIT BYTES TO STORE 



NOTE: See descriptions in "aids" of TUTOR versions of -xout- and -xin- for 
current information on device addresses. 



i 
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intrupt specifies a unit to execute (via -do-) when an Interrupt Is received 
from an external device 

Intrupt UNIT NAME 

Intrupt EXPR,NAMEM,NAME0,x,NAME2,q (example of conditional form) 



trap traps output from the central system In the specified buffer; executes 
the trapped output; traps status of the terminal 

trap save;STARTING VAR,NUM 8-BIT BYTES (traps output) 

trap play;STARTING VAR,NUM 8-BIT BYTES (executes trapped output) 

trap status ;STARTING VAR,NUM 8-BIT BYTES (saves terminal status 

seen by the central system; saves 27 bytes) 
trap terminal; STARTING VAR,NUM 8-BIT BYTES (saves terminal status 

seen by the juTUTOR executor; saves 27 bytes) 
trap save,play; STARTING VAR,NUM 8-BIT BYTES 

(saves and executes trapped output) 

Note: zreturn = number of 8-blt bytes trapped in the buffer 

NOTE: The following commands have identical forms to their TUTOR counterparts: 
-at-, -atnm-, -circle-, -draw-, -dot-, -box-, -plot-, -fill-, -vector-, 
-enable-, -disable-, -play-, -record-, -slide-, -beep-; 

graphing commatids: -gorigin-, -axes-, -bounds-, -scalex-, -scaley-, 
-labelx, -labely-, -markx-, -marky-, -gdot-, -gdraw-, -gbox-, -gat-, 
-gatnm-, -vbar-, -hbar-, -gvector-. 

With graphing commands these restrictions hold: -labelx- and -labely- 
require an explicit format for the labels in the format for -showt-. 
There are no default values for: -gorigin-, -axes-, -bounds-, -scalex-, 
and -scaley-. These parameters must be set explicitly. 

relative commands: -rorigin-, -rat-, -ratnm-, -rdot-, -rdraw-. 
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Exchanging Information with the central system 



xmit permits exchange of data between the terminal and the central system; 
when -xmit- is in the TUTOR part of a program, data is sent to the 
terminal for use in a pTUTOR program; when -xmit- is in the jiiTUTOR 
part of a program, data is se*^^, to the central system for processing 
in a TUTOR program 

jtiTUTOR form (sends an 8-bit value to the' central system, where it 
is processed as an external key, i.e., a key from an 
external device Ito pick up data from a single -xmit-, 
-pause keys«ext- and processing of "key" must follow the 
-runu- command^ to pick up data from any number of -xmit- 
commands, -enable ext- and -collect- must follow -runu-]) 

xmit EXPR 



TUTOR form (daUa is in the form of horizontal segments; byte size of 
data < 16; number of 8-bit bytes received is in "zdata"; 
the data is picked up by the ;iiTUTOR program by the 
-receive- command) 

xmit STARTING VAR,NUM SEGMENTS, SEGMENT SIZE (opt) 

(SEGMENT SIZE, if omitted, is 60; if SEGMENT SIZE > 16, 
only the right-most 16 bits are sent) 

Note: After the TUTOR -xmit-, 

zreturn = -1 if the data is transmitted successfully 
« 0 if no juTUTOR program is loaded 
« +1 if the STOP key is pressed during transmission 



receive collects data that is sent to the terminal from the central system 
(by -xmit-) 

receive STARTING VAR,NUM 8-BIT BYTES 

Note: If the byte size for data transmitted from the central system 
is > 8, the byte size for the receiving buffer muec be 16* 



sendkey (no tag) sends the current keyset key to the central system 
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Routing 

lesson sets the system variable "zldone" to indicate- whether a lesson is 
considered complete 

lesson complete (sets "zldone" to -1) 

lesson incomplete (sets "zldone" to 0) 
lesson no end (sets "zldone" to +1) 

lesson EXPR, complete, Incomplete, X, no end (example of conditional 
form; argument x leaves "zldone" unchanged) 

score places the value of the tags rounded to the nearest integer, into the 
system variable "zscore" 

score EaPR (value from 0 to 100) 
score (B) (sets "zscore" to -1) 
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Sequencing 



juppn jumps to the specified unit but does not do any initializations, 
such as screen erase; clears the -do- stack 

jumpn UNIT NAME 

jumpout causes immediate execution of the specified lesson on the floppy disk 
connected to the terminal 

jumpout LESSON NAME (variable tag must be an intego.r variable and 

must be enclosed in parentheses) 
jumpout (B) (returns to the router lesson on the floppy disk) 

press puts the specified key into the student input buffer 
pr€Sf^ (zk (LETTER)) 

press FUNCTION KEY (use lower case, e.g., -press next-^ 
press (EXPR) 

getkey (no tag) reads the next key from the key buffer and sets "zkey" to 

the value of the next key (sets "zkey" to -1 if the buffer is empty) 

clrkey (no tag) clears the key buffer 

NOTE: The following commands have identical forms to their TUTOR counterparts: 
-branch-, -if-, -elseif-, -else-, -endif-, -loop-, -reloop-, -outloop-* 
-endloop-, -cstart-^ -estop-, -estop*-, -use-, -keytype-, -keylist-, 
-pause-. 

The following commands have identical forms to their TUTOR counterparts 
with restrictions as noted: 

-next-, -nextl-, -back-, -backl-, -help-, -helpl-, -data-, -datal-, 
-lab-, -labl-, -stop-, -imain-, -goto-, -do-, -jump-, -base-, -doto-. 

Argumented units are not available* 

Conditional expressions must conform to restrictions on calculations. 
There is no iterative -do-. 

Tag "q" must be used to inactivate a key; blank tag is not available. 
Explicit -next- command is required to proceed. (Automatic sequencing 
is not available.) 

There is no -end- command; a help-type sequence ends with a unit with 
no -next- command. 

Only the blank-tag form of -base- is available. 
With -doto- all index values must be integers. 
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Running assembler programs 

AIj. commands in this subsection must be executed In a TUTOR program. 



pptaddr establishes a base address or location In the read/write memory of 
the terminal for subsequent loading, testing, running, and clearing 
of a program or for loading of data 

pptaddr ADDRESS 

;>ptaddr ADDRESS FOR LOADING, ADDRESS FOR RELOCATING 

pptaddr (B) (sets base address to default, which Is "ztbase"+2048) 



pptload loads and relocate s. If required, the program In the specified 

binary block at the location specified by the previous -pptaddr-; 
if LESSON NAME is omitted, the current lesson is assumed 

pptload LESSON NAME (opt), BLOCK NAME 

pptload (B) (clears all flags indicating that programs are loaded 
into the terminal's memory) 



Note: zreturn = -1 if program is loaded successfully 

= 0 if the binary block is not found 

= 1 if the STOP key is pressed during loading 

= 2 if the terminal is not programmable 

= 3 if the binary has a bad length 

« 4 if there are too ma.ny programs in memory 

= 5 if there is an error in the binary format 

= 6 if there is a system disk error 



ppttest sets "zreturn" to test whether the specified binary block is loaded 
in the terminal's memory at the address specified by a previous 
-pptaddr-; if LESSON NAME is omitted, the current lesson is assumed 

ppttest -LESSON NAME (opt), BLOCK NAME 

Note: zreturn » -1 if the binary is loaded at the previously 

specified address 
= 0 if the binary is rot loaded at that address 



pptclr clears the flag indicating that the specified binary block is loaded 
in the terminal's memory at the address specified by a previous 
-pptaddr-, or clears flags for all binaries; If LESSON NAME is omitted, 
the current lesson is assumed 



pptclr LESSON NAME (opt), BLOCK NAME 
pptclr (B) (clears all flags) 
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pptdata loads data from student variables or central memory variables into 
the terminal's memory, starting at the address specified by a 
previous -pptaddr- 

pptdata STARTING VAR,NUM SEGMENTS, SEGMENT SIZE (opt) 

(SEGMENT SIZE, if omitted, is 60; if SECMENT SIZE > 8, 
only the right-most 8 bits are sent) 

Note: zreturn « -1 if data is sent successfully 

« 0 if the STOP key is pressed during transmission 
« +1 if the terminal is not programmable 



pptout sends data words and control words stored in student variables or 

central memory variables to the terminal; each "package" of data 

consists of a 19-bit word which specifies a terminal function; 
(LDE, or load echo, is not permitted) 

pptout STARTING VAR,NUM VARS (opt) (NUM VARS, if omitted, is 1) 

Note: zreturn » -1 if data is sent successfully 

= 0 if the terminal is not programmable 

Note: For a complete description of the data words and control words, 
see "The PLATO V Terminal" by Jack Stifle* 

pptrun causes execution of the program rasiding at the address specified by 
a previous -pptaddr-, or specifies the entry to be executed in a 
jump table at the beginning of the program residing at the address 
specified by a previous -pptaddr- and sends an 18-bit data word, if 
requested 

pptrun (B) (executes the program at the previously declared address) 
pptrun JUMP TABLE ENTRY , DAT AWORD (opt) (executes an instruction 
in a jump table; DATAWORD, if omitted, is 0) 

Note: zreturn = -1 if -pptrun- is successful 

= 0 if the terminal is not programmable 
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System variables for terminal resident processing 



NOTE: System variables which appear only in a TUTOR program are Indicated. 

zanscnt number of response-matching commands encountered at an arrow 
before the response is matched; = -1 if no tag is matched 

zcomm provides a counter for timing interrupts; Incremented each time an 
Interrupt is received 



zdata number of 8-blt bytes of data sent from the central system by -xmit- 



, zentlre = -1 if all required words are present in the response, = 0 otherwise 



zextra = -1 if there are no extra words in the response, = 0 otherwise 

zjcount number of charact '^rs entered at a ^TUTOR -arrow- 

zjudged = -1 for any "ok" judgment 

= 0 for any "wrong" judgment (anticipated "no") 

= 1 for any "no" judgment (unanticipated "no") 

=» 2 for. a reyponse which is not matched 



zkey contains the keycode of the last input (updated after -arrow-, 
-pause-, -getkey-, and at the beginning of a main unit) 



zldohe -1 if the user has encountered -lesson complete- 

=» 0 if the user has encountered -lesson incomplete- 
+1 if the user has encountered -lesson no end- 



zntries number of attempts at the current arrow 

zorder = -1 if the word order is correct, 0 otherwise 



zreturn set by some commands according to the results of execution; set by: 

-attach-, -charset-, -compute-, -datain-, -dataout-, -loadu-, -putd-, 
-loadu-, -trap-, -pptdata-, -pptload-, -pptout-, -pptrun-, -ppttest- 
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zrouten indicates entry conditions to the router lesson: 

=» 0 if this is the first entry to the router lesson 
« 1 if this entry to the router is via -jumpout- 

= 2 if the router is returned to when the end of the instructio ;al 

lesson is reached 
" 3 if the router is renamed to when the instructional lesson is 

terminated by STOPl keypress 
= 4 if the router is returned to when an execution error occurs 

in the instructional lesson 



zscore rounded value of the tag of jiiTUTOR -score- (value from 0 to 100) 
zspell = -1 if spelling is correct, = 0 otherwise 



ztbase (TUTOR) address of the first available read/write memory byte in 
the user's terminal 



ztmem (TUTOR) number of 8-bit bytes of memory for the user's terminal 



ztmemr (TUTOR) number of available 8-blt bytes in the terminal's memory 
after a -loadu- command 



ztprog (TUTOR) « -2 if the user's terminal ip programmable and pTUTOR is 
available 

= -1 if user's terminal is programmable and /uTUTOR is not available 

= 0 if user's terminal is not programmable 



ztrap number of bytes of output pending from the central system; each 
terminal word is 3 bytes, so "ztrap" is a multiple of 3 



zttype gives information on the user's tenninal; counting from the left end 
of the 8-bit word: 
1 bit: always 0 

3 bits: memory configuration (see "aids" for details) 

4 bits: terminal type 

=» 0 if the terminal is a PLATO IV 
=» 1 if the terminal is a PDF 

« 2 through 7 if the terminal is an 1ST (5 for IST2) 
« 8 through 10 if the terminal is a PPT 
(these values are subject to change) 

Note: The TUTOR version of "zttype" contains only the information 
on terminal type» 




zwcount number of words in the response (maximum of 50) 

1 i \j 
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zwherex fine-grid x location for the next display in juTUTOR processing 
zwherey fine-grid y location for the next display in juTUTOR processing 
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Limits associated with conunands (for TUTOR version unless specified otherwise) 

10 characters in name of area 



area 



args 

argumented unit 
arlieada 



box 
gbox 
rbox 

bump 

calcc 
calcs 

charlira 

common 

comload 

compute 

conditional form 
of commands which 
reference unit 
names, s-g*, -next-, 
-help-, etc* 

cpulim 

define 



10 arguments 

five 6-bit characters 

95 dots thick 

8 characters 

61 calculations 

value of tag from 0 to 127 

8000 variables (>1500 variables requires -comload-) 
1500 variables 

100 characters in character string 

100 unit names (line containing 101st name is flagged 
as a condense error) 



delay 
deletes 
do 

join/ 

draw 

gdraw 

rdraw 

edit 



combined 



value of tag from 1 to 10 

7 characters in name of define set 
7 characters in name of variable 

1500 definitions (fewer if definitions are complicated) 

500 definitions in define set "student" 

6 arguments in defined function 

10 units (e.g., kg, m, sec, liter, etc.) 

255 eleraents in an array 

5 active define sets 



1 second maximum 

value of increment from 1 to 

10 levels 



63 arguments 

maximum of 300 characters in buffer 
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endings 



10 separate -endings- commands, 8 endings in each tag 



finds 
findsa 

graph 

group 

hbar • 
vbar 

inserts 

keylist 

keytype 

labelx 
labely 
markx 
marky 

list 

loada 

loadu 

long 

Ivars 

move 

name 

noword 
okvord 

outpu 1 

pack 

packc 

paus^ 

press 

put 

putd 

putv 



value of increment from 1 to 500 

9 characters in string to be plotted 

8 characters in sign-on group name 

9 characters in string to be plotted 

(increment between entries) >^(number of entries to add) < 500 

from 2 to 7 characters in the name 

100 keys in tag (key lists count as one key) 

100 marks maximum plotted on an axis 

7 characters in name of list 
300 characters ^ 
20 units 

300 characters (>150 requires -edit- for active EDIT key) 

128 local variables 

5000 characters mey be moved 

18 characters in sign-on name 

9 characters in word 

10 characters in label, 20 consecutive variables 
500 characters in character string (with embeds) 
100 character strings 

•75 second minimum 
1 keypress per second 

50 characters in strings; expansion due to string 
replacement limited to 300 characters 

7 ^ ^ 

-1 / *:t 
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randu 

return 
routvar 
score 
set 

setdat 

setperm 

sort 
sorta 

storage 

term 
termop 

time 

tlmel 

timer 

transf r 

unit 

unltop 

entry 

vocab 
vocabs 

*ll8t commands 



Integer from 1 to 2^^ (TUTOR) 
Integer from 1 to (2^5 ^ i) (^tUTOR) 

10 argumen-3 

64 variables 

value of tag from 0 to 100 (TUTOR and /uTUTOR) 
up to 61 separate values 

value for "atlme" less than elapsed time for the session 
values for "aarrows", "ahelp", etc. less than 512 

(one-argument) integer from 0 to 120 
(two -a argument) integer from 0 to 3000 

value of increment from 1 to 200 



8000 variables 

8 characters in string, 299 terms in a lesson 



•75 second minimum 
•75 second minimum 
60 seconds minimum 
length is the smaller of: 

size of common or storage (reference to ECS) or 
length of -comload- or -stoload- (reference to CM) or. 
150 (reference to student variables) or 
tag of -routvar- (reference to router variables) 

8 characters in name 

500 condensed words in a unit 

394 distinct condensed units in a lesson 

7 characters in name of vocabulary 

10 commands 
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Standard PLATO Keyset 



MICRO . plots period +•? spaces 

MICRO Q writes to left from current position 

MICRO R writes to right from current position 

MICRO CR writes to left in alternate font from 

right edge of screen 

MICRO T writes in holdface (thick) font (on ppt) 

MICRO S writes in standard font (on ppt) 
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3 


o64 


1 


1 1 1 


= 


ol57 


h 


3 


3 


Ol0 




53 


= 


o65 


n 


1 12 




ol60 


i 


9 


= 


ol : 




54 




o66 




116 




ol64 


J 


10 




ol2 


3uper 


55 


= 


o6 7 


1 ocksub 


118 




o I 66 


t. 


I I 


= 


013 




56 




o7 0f 


1 ocksup 


119 


3 


ol 67 


I 


12 


3 


Ol4 


car ret 


57 


3 


o71 




127 




ol77 


m 


13 


= 


ol5 


< 


58 


3 


o72 




12o 


= 


o200 


n 


1 4 




ol 6 


> 


59 


= 


o73 


hiEXT 


130 


= 


o:'3f2 


o 


\S 




ol7 


bkspacs 


60 


3 


o7 4 


NEX*^1 


131 




o203 


P 


16 




o20 


font 


61 


3 


o75 


£RmSE 


132 




o204 


q 


1 7 


3 


o21 


access 


62 


3 


o76 


ERRSEl 


133 


3 


o205 




13 


= 


o22 


> 


63 


= 


o77 


HELP 


134 


= 


o206 


•3 


19 




o23 


R 


65 


3 


ol>Jl 


HELPl 


135 


= 


o207 


t 


2^ 




o24 


B 


66 


3 


oi02 


5RCK 


136 




o2 10 


U 


21 


= 


o25 


c 


67 


= 


ol03 


ERCKl 


137 




o2ll 




22 


= 


o26 


D 


63 


3 


ol04 


LRB 


138 




o212 


W 


23 


= 


o27 


E 


69 


3 


ol05 


LRBl 


139 


= 


0213 




24 


= 


o30 


CT 
1 


70 


= 


ol06 


DRTR 


140 


r- 


o214 


y 


25 


= 


o31 


G 


71 


a 


ol07 


DRTRl 


141 


3 


o215 




26 


a 


o32 


H 


72 




ol 10 


TERM 


142 


= 


o2 16 




27 




o33 


I 


73 


3 


ol 1 1 


RN3 


143 


3 


o2 17 


1 


28 


3 


o34 


J 


74 


= 


ol 12 


COPY 


144 




o220 


2 


29 




o35 


K 


75 


= 


ol 13 


CCPYl 


145 




. * 


3 


3? 


= 


o36 


L 


76 


3 


0114 


EDIT 


146 




o222 


4 


31 


= 


o37 


n 


77 


= 


oils 


EDITl 


147 


a 


o223 




32 


3 


o40 


M 


73 


3 


ol 16 


MICRO 


1 4? 


= 


o224 


6 


33 


3 


o41 


0 


79 


3 


ol 17 


SQURRE 


1 49 


= 


o225 


7 


34 




o42 


p 


30 




ol20 


STOP 


150 




^226 




3 r. 




o43 


Q 


31 




ol21 


STOf^l 


151 




0227 


9 


36 




o44 


R 


32 


3 


ol22 


TRB 


152 




o230 


+ 


37 




o45 


S 


83 


3 


ol23 


TIMEUP 


155 




o233 




33 


S 


o46 


T 


84 




0124 


CRTCHUP 


157 




o235 




39 




o47 


U 


35 




ol25 


touch- 


256 




o400 




40 




O50 


y 


36 




0126 


panel 


i 




i 


( 


41 


3 


o51 


w 


87 




ol27 


: np-uts 


511 




o7 7 7 


) 


42 




o52 


X 


33 


3 


ol 3.£r 


ext er na 1 


512 




O1000 




43 


a 


o53 


y 


39 


r\ 


0131 


inpu,ts 


i 




i 




44 




o54 




90 


3 


ol32 




767. 




ol 377 


ace 






o55 



















^ "key" corrfcains the keycode of the last key pressed. 
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INTERNAL CODES 



unshi fted 
cl .ar code 

001 

oi3f2 
O03 
O04 
O05 
O06 
c-07 
ol0 
ol 1 
ol2 
ol3 
ol4 
oi5 
ol5 
ol7 
o20 
o21 
o22 
o23 
o24 
c25 
o26 
o27 
030 
o31 
o32 
o33 
o3 4 
o3? 
o36 
o37 
O40 
o4l 
o42 
o43 
. o44 
o45 
046 
o47 
oS.Qf 
o5l 
o52 
o5 3 
o5 4 
^ o55 



Shi fted 
char code 



B 
C 
D 
E 
F 
G 
H 
I 
J 
K 
L 

n 

N 
0 

p 

Q 
R 
3 
T 
U 
V 

I.J 
X 
Y 
■Z 



O7001 
O7002 
O7003 
O7004 
O7005 
O7006 
O7007 
O7010 
O7011 
O7012 
O7013 
O7014 
O7015 
o701 6 
O7017 
o7020 
O7021 
O7022 
o70r23 
O7024 
O7025 
O7026 
O7027 
O7030 
O7031 
O7032 



access 
char code 



left64* O7033 



lefi 



O7034 



right* O7040 
O7041 
O7042 
bold* O7043 
linbold* O7044 
I O7045 
A O7046 

? <>7050 



e 



< 
> 



'':;;pece 



O7601 
O7602 
O7603 
O7604 
O7605 



07614 
07615 
07616 
07617 
O7620 
o7621 
07622 
07623 
07624 
07625 
07626 
07627 
O7630 



07633 
07634 



O7u40 
S> 07641 



07645 



o7d50 

07652 
o76?3 
07654 
07655 



access-shi fted 
char code 

4- O767001 

(c) O7 67003 
O7 67004 

♦ O767006 



I O76701 I 



O76701 7 



t O767027 
4. O767030 



J 73 



INTERMRL CODES (cent , ) 



unshi fted 
libar code 

o5 7 



] 

% 

y 

sub 

super 
■3hi ft 
C5ir ret ^ 
< 

> 

bkspace 

f-:..nt 
acccrss 



06 1 
o62 
06:3 
06 4 
065 
.0 6 6 

06 7 

o71 
o72 

07 3 
o7 4 
o7 5 
o7 6 
o7 7 



ahifted 
:h<?.r code 

O7056 
! 07VJ57 



O7064 
locksub 0706 6 

Idnlin- o70;i 



07077 



cbar 



{ 



cr gr' 

dnl in-^ 
upl in'- 



o7 656 



o766 I 
o7662 

c7664 
C' 7 6 6 5 
o7 66 6 
0.7667 



crUJl- o767 1 

< 07 6 72 

> o7 6 7:3 

. Sbksp o76 74 

o 7 6 7 7 



acc <=S3 -shifted 
char rc'de 



o76^iZf64 



Idrl in' 

I up I m ^ 



7 6 ' 



' u t fj 

• 5f67 



^^NOTE: 
left64; 

lt;ft: 

r 1 ght : 
bold: 
unbold: 
cr 01 : 
dn 1 m : 
1 dn H n : 
upl in: 
I up 1 i n : 
car ret: 
or 101: 



^^jrite to left, starting at character position 64 
write to left, starting at "where" position 
u/rite to right, starting at "where" position 
t,vrrite in bold characters Cppt only) 
write in standard characters (ppt onlv) 
carriage return to next line, character position I 
write next character down one line Od-M^jn 16 c 
same as dn 1 i n except 1 ock i ng 
write next character up one line (up 16 dots) 
same as upl in except locki'.tg 
standard carriage return to next line, left 
carriage return to scrtjen position 1.0' I 



3J 



marg i n 



The following characters, although produced with the shift 
key, do not produce a shift code in the internal code: 
* , ( J ) , ^ , [ < ] y , <^ i > , car ret , backspace , and f ont . 
In this table these characters are in the '"unshi fted" 
category. 



180 



A8 



ALTERMRTE FONT TERMINRL MEMORY LOCATIONS 
(key associated with terminal memory location) 



w w 


key 


1 

1 oc 


key 


loc 


key 


loc 


key 


1 oc 


kes.' 




space 


2 / 




54 


Ck) 


S 1 


Q 


108 


) 


1 


a 


2 y 


1 


55 


CD 


8 2 


R 


109 


CE) 


z 


b 


29 




56 


(mj 


3 3 


•IT' 


1 1 0 


I..F.J 


3 


c 


30 


3 


57 




34 


T 


1 1 1 


CG) 


4 


d 


3 1 


4 


58 


Co) 


85 


IJ 


1 12 


n 






32 


5 


59 


r 
? 


3 6 


y 


1 1 3 


CH) 


6 


f 


3 3 


6 


60 




8 7 


hi 


1 14 


CI) 






34 


7 


6 1 


J 


88 




1 1 5 


CD 


Q' 


h 


3 5 


3 


■62 


• 


3 9 


Y 


1 1 6 


u 


9 


i 


36 


9 


63 


unav 


90 




1 1 7 




10 


j 


3 7 


+ 


64 


space 


9 1 




1 1 3 


CK) 


1 1 


k 


38 




65 


R 


92 




1 1 9 


■ CD 


12 


1 


3 9 


(a) 


66 


B 


93 


[ 


120 


CM) 


1 3 


m 


40 


/ 


67 


C 


9 4 


] 


1 2 1 


CN) 


1 4 


r 


41 


i..bj 


6 8 


D 


9 5 




1 22 


CO) 


1 5 


o 


42 


(c) 


6 9 


EI 


9 6 




1 2 3 




16 


p 


43 


Cd) 


70 


F 


9 7 




124 


! 


1 7 


q 


44 




7 1 


G 


9 13 


I 


1 2 5 


C ! ) 


18 


r 


45 


Ce) 


"7 


H 


9 9 




126 


C . ) 


19 




46 


t" ■) 


73 


I 


1 00 


( 


127 


unav 


20 


J- 


47 


(g) 


74 


J 


101 








21 


U 


48 




75 


K 


102 








22 


V 


49 


Cn) 


76 


L 


103 


(R) 






23 


w 


50 


Ci) 


77 


M 


104 


9 






24 


X 


51 


(j) 


78 


n 


105 


CB) 








y 


52 


X 


79 


0 


106 


(C) 






26 


4«' 


53 


4= 


30 


p 


107 


CD) 







NOTE: 



ERIC 



unav ; 
(key) : 



Locat i on i s unava i 1 ab 1 e on s t andar d t erm i na 1 
Press MICRO followed by the indicated key. 



A9 



KEYCODES- 
'"prcgrammab let *rm i na 1 ) 



key 


key<:ode 


key 


keycode 


key 


keycode 


key 


keycc 


t i meup 


-I 
















0 


< 


32 


space 


64 


bksp 


96 


I 


I 


> 


33 


a 


6? 


R 


97 




2 


I 


34 


b 


66 


B 


93 


3 


3 


] 


35 


o 


67 




99 


4 




S 


36 


d 


6 3 


D 


100 


5 


5 




■V { 


e 


6 9 


E 


101 


6* 


0 




33 


f 


75" 


p- 
r 


102 


7 


7 




39 




•71 


G 


103 


3 


3 




40 


h 


72 


M 


104 


9 


9 


r 


41 


i 


f -J* 


I 


105 


■< 


lif 


■J 


42 


j 


74 


T 


106 


J, 


11 


o 


43 


k 


^5 


K 


107 




12 


or 


44 


1 


7 6 


1 

L_ 


103 




13 




45 


m 


/ / 


M 


109 


+ 


14 




46 


n 


73 


N 


110 


— 


i? 


A 


4:^ 


o 


7 9 


0 


I 1 1 


sup 


Id 


sup I 


-3 


P 


30 


P 


112 


sub 


17 


5Ubl 


^9 


q 


31 


Q 


1 13 


ans 


li3 


term 


50 


r 


32 




1 1 4 


erase 


19 


erase 1 


51 


3 


33 




115 


m i cro 


20 


font 




0. 


34 


T 


1 16 


help 


21 


helpl 


53 


L', 


35 


u 


1 I 7 


next 


■7" *? 


next I 


54 


V 


8 5 


V 


113 


edit 


23 


editl 


55 




0 / 


w 


i ;.9 


back 


24 


back! 


56 


X 


?< R 




120 


data 


? c; 


data 1 




y 


3 9 


./ 


121 


atop 


26 


stopl 


53 




90 


z 


122 


copy 


'? 


copy I 


59 




9 I 


) 


123 


square 


23 


square I 


6.^ 


» 


9 2 




124 


Lab 


2 9 


iabl 


51 


/ 


9 3 




125 












9 4 


1 


126 










1 


95 




127 



System variable "skey" contains the keycode of the last 
i np-ut . 

Function "zk" returns keyset keycode values. 
Touch-panel input codes ran^e from 256 to 511. 
External input codes ranjge from 512 to 76 7. 



182 



A10 









2' 


0 






1 


1 






2 


2 






4 


3 






8 


4 






1 6 


5 






32 


6 






64 


7 






128 


8 






256 


g 






512 






1 


jJ24 


11 




2 


J348 


12 




4 


JZf96 


13 




8 


192 


14 




1 6 




15 




32 


768 


16 




65 


536 


17 




131 


072 


18 




262 


144 


19 




524 


288 


20 


1 


SS4& 


576 


21 


2 


097 


152 


22 


4 


194 


3JZf4 


23 


8 


388 


6jZf8 


24 


16 


777 


216 


25 


33 


554 


432 


26 


67 


1ja8 


864 


27 


134 


217 


728 


28 


268 


435 


456 


29 


536 87jZf 


912 



Powers of 2 



n 2^ 

=8^ 30 1 ^73 741 824 =8^^ 

31 2 147 483 648 

32 4 294 967 296 
=8 33 8 589 934 592 =8 

34 17 17C' "369 184 

34 359 738 368 

=8 36 68 719 A'^S 736 =8 

37 137 438 96i 472 

38 ' 274 877 9^6 944 
=8 39 549 755 813 888 =8 

4J3 1 J399 511 627 776 

41 2 199 023 255 552 

=8 42 4 398 JJ46 511 1JZf4 =8 

43 8 796 JJ93 i322 2JZf8 



44 17 592 186 044 416 



15 



=8" 45 35 184 372 JJ88 832 =8 

46 70 368 744 177 664 

47 14j2f 737 488 355 328 

=8 48 281 474 976 7^0 656 =8 

49 562 949 953 42i 312 

50 1 125 899 906 842 624 

=8 51 2 251 799 813 685 248 =8 

52 4 5p 599 627 37j3 496 

53 9 007 199 254 74^ 992 

=8 54 18 ^14 398 5j2f9 481 984 =8 

55 36 02B 797 0^8 963 968 

56 72 057 594 037 927 936 

=8 57 144 11 El 18B 075 855 872 =8 

58 288 23J2f 3?6 151 711 744 

59 576 46^f 752 3J2f3 423 488 



Given the byte size = n: range for unsigned integers is 0 to 2^-1 

range for signed integers is -(2^ ^-1) to +(2^ ^-1) 

Given the maximum absolute value such that 2^ ^ < ImajKimuml < 2^^: 



byte size for unsigned integers is n 
byte size for signed integers is n+1 



EKLC 



J So 



INDEX 



Alphabetical index to system variables 

System variables may be used wherever expressions are accepted, e.g., in 
of -calc-, -at-, etc. 



Word 


Page 


Word 


Page 


tford 


Page 


Vord 


Page 


a are a 


D6 


mallo t 


S21 


zc ond 0 k 


S22 


zrof f 


F19 


aarrows 


D6 


mode 


P21 


zcpw 


C22 


zrouten 


T26 


a help 


D6 


muse 


S21 


zcusers 


C22 


zr statn 


F19 


ahelpn 


D6 


nhelpop 


S22 


zdata 


T25 


zr type 


F19 


an sent 


J19 


n tries 


J19 


zentire 


T25 


zrvar s 


F19 


ansok 


J19 


opcnt 


J20 


sex tra 


T25 


zrvret 


F19 


aok 


D6 


ord er 


J20 


zf acc 


F18 


z score 


T26 


aokist 


D6 


phrase 


J 20 


zfile 


Fi8 


zsessda 


D6 


args 


S21 


proctim 


S22 


zf roml 


S22 


z se s se t 


D6 


a sno 


D6 


p titae 


S22 


zf romu 


S22 


z se ssp t 


D6 


a term 


D6 


rcallow 


R3 


jf t:\pe 


F18 


z snf ile 


S23 


a termn 


D5 


router 


R3 


zf user s 


Fi8 


z sno tes 


S23 


a t iiae 


U? 


r star tl 


R3 


zgroup 


S22 


z spell 


T26 


auno 


D7 


r star tu 


R3 


zid 


S22 


z svar 3 


F19 


bac kout 


S21 


rvallow 


R3 


zinf 0 


F18 


z svret 


F19 


baseu 


S21 


si tenam 


S22 


zj count 


T25 


z sysid 


S23 


cap! cal 


J19 


size 


P21 


z judged 


T25 


z systera 


S23 


clock 


S21 


sizex 


P21 


zkey 


T25 


z tbar-^ 


T26 


da taon 


DC 


sizey 


P2l 


zlanf5 


P21 


z term 


S23 


entire 


J19 


spall 


J20 


zldone 


T25 


z tmeir. 


T26 


err type 


R3 


station 


S22 


zleserr 


R4 


z tmerar 


T26 


extra 


J20 


tac tive 


S22 


zlesson 


S23 


z to uc hx 


S23 


f ormok 


J21 


L5 ser 


S22 


zline 


F18 


z to uchy 


S23 


f romnum 


S21 


user sin 


S22 


znindex 


F18 


z tprog 


T26 


j count 


J19 


varcnt 


J20 


znscpn 


F18 


z trap 


T26 


judged 


J19 


vocab 


J20 


znsmaxn 


F18 


z t.type 


T25 


key 


S21 


wc oun t 


J20 


znsr.^axr 


F18 


z t z on e 


S24 


Icoraraoa 


C22 


where 


P21 


znsnams 


F18 


zuni t 


S24 


Id one 


R3 


wherex 


?21 


znsrecs 


F19 


zusers 


S24 


lessnuiTi 


S21 


wherey 


.21 


entries 


T25 


zwcount 


T26 


lleslst 


S2i 


zaccnam 


S22 


zorder 


T25 


zwherex 


T27 


llessoD 


S21 


zan sent: 


T25 


zpnf ile 


323 


z wherey 


T27 


Isc ore 


R3 


zbpc 


C22 


zpno tes 


S23 


zwpb 


F19 


Ista tus 


R3 


zbpw 


C22 


zrecs 


F19 


zwpr 


F19 


Istorag 


C22 


zcheck 


F18 


zretrnu 


S23 


zxf ile 


F19 


ma inu 


S21 


zcomra 


T25 


z return 


S23 







.1.84 
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Alphabetical ind'ix to comraands cind related directives 



i C Comniand Page 



abort C19 

addlst S15 

addl C3 

. addname F4 

addrecs F5 

allow Rl 

allow T18 

altfont P20 

■ F ans J12 

an su Jl 1 

ansv J11,T11 

answer J9,T11 

answerc J10,T11 

array CI 

area D2 

I J args S13 

argument S1,S2 

arheada J2 

arrow J2,T9 

arrowa J2 

at PUT19 

I M atnm P1,T19 

attach F1,T8 

audio PI 6 

axes F10,Tii^ 

B p back S7,T22 

backl S7,T22 

backgnd C21 

backop S7 

backlop S7 

■ R base S8,T22 

beep P17,T:' 

block C18,T5 

bounds P10,T19 

. be. P6,T19 

■ ^ bi ach S4,T22 

break * Sll 

bump J5 

c S17 

calc C3,T3 

calcc C3,T3 

calca C3,T3 

H T catchup £11 

change S17 

char P5,T17 

charlim T17 

charset P19,T17 

chartst P20 

B A checkpt F13 

circle P7,T1> 



^ r 



Command 


Page 


Command 


circleb 


P7 


end loop 


clean 


C13 


entry 


clock 


C10 


erase 


close 


J5 


eraseu 


clrkey 


T22 


exact 


collect 


S9 


exac tc 


comload 


C19 


exac tv 


common 


C19 


exac tw 


commonx 


C20 


exit 


compare 


J14 


ext 


comret 


C19 


ex tout 


compute 


C10,T4 


fill 


concept 


J10 


find 


copy 


J3,T10 


find all 


c p ul im 


sri 


f indl 


c start 


S]4,T22 


finds 


c stop 


S14,T22 


find sa 


c stop* 


S14,T22 


finish 


d arrow 


T9 


force 


data 


S7,T22 


f oregnd 


datal 


S7,T22 


from 


datain 


F2,T8 


f unct 


dataof f 


Dl 


gat 


dataon 


Dl 


gatntu 


dataop 


S8 


gbox 


datalop 


S8 


gcircle 


dataout 


F2,T8 


gdot 


date 


C10 


gdraw 


day 


C10 


getchar 


define 


C1,T3 


getcode 


delay 


P4 


getkey 


deletes 


C16 


getline 


delname 


F5 


getloc 


delrecs 


F5 


getmar k 


d el ta 


P15 


getn ame 


detach 


Fl 


getword 


d isable 


P16,T?9 


gorigin 


do 


S2,I2 ' 


goto 


dot 


P6,T19 


graph 


doto 


S4,T20 


group 


draw 


?6,T1P 


gvec tor 


edit 


J2 


i\a 1 tu 


el se 


S5,T22 


hbar 


elseif 


S5,T22 


help 


embed 


P1,T15 


helpl 


enable 


116, T19 


helpop 


ead 




helplop 


endarrow 


•13, T9 


hidden 


end if 


S5,T22 


htoa 


endings 


J4 


iarrow 



1 9 ^ 



Page 


Command 


Page 


S6,T22 


i arrowa 


J16 


SI 


leu 


SI 


P3,T16 


if 


S5,T22 


Jl 


if error 


S3 


.J10,T11 


ifmatch 


T12 


J10 


igno re 


J15 


Jll 


ijudge 


T12 


Til 


imain 


S3,T22 


S3 


in 


SI 3 


PI 7 


inhibit 


P5,T18 


P17 


Initial 


C20 


P6,X19 


inserts 


C16 


C17r'5 


in tr up t 


T19 


C17 


io spec s 


F15 


S16 


Itoa 


C12 


C15 


jkey 


J2,T9 


C15 


j oin 


J16,S3 


D5 


judge 


J17,T13 


J1,T9 


jump 


S2,T22 


C21 


j umpn 


T22 


S13 


j umpout 


S12,T22 


P15 


keylist 


S9,T22 


P12,T19 


keytype 


S10,T22 


P12,T19 


kejfword 


T10 


P13,I19 


lab 


S7,T22 


P13 


labl 


S7,T22 


P13,T19 


labelx 


P11,T19 


P13,T19 


labely 


P11,T19 


T17 


labop 


SB 


S10 


1 ab 1 op 


SB 


T22 


lang 


P3 


F16 


leslist 


S15 


J14,T14 


lessln 


S13 


J13,T14 


lesson 


R2,T21 


F4,F14 


1 Inese t 


P20 


J13 


list 


J4 


P10,T19 


Iname 


S16 


S2,T22 


loada 


J5 


P13 


loadu 


Tl 


C10 


long 


J2,T9 


P14,T19 


loop 


S6,T22 


T2 


1 scalex 


Pll 


P14,T19 


Iscaley 


PU 


S7,T22 


Ivar s 


C3 


S7,T22 


markup 


JIB 


S8 


mar kupy 


JIB 


S8 . 


markx 


P11,T19 


P3 


mar ky 


P11,T19 


C12 


luatch 


J9 


J16,T12 


micro 


P19 



Alphabecicai index ro conunauds and related direccives (cont.) 



uoinnidna 


rage 


Comnand 


niisc on 




read se t 




pa t 1 a 


receive 


niod pe rni 






move 


LIZ 


r e c 0 rd 


narn6 




r ec crd s 


u jmes 


r 0 , r ID 


r el ease 


next 


c 7 T 9 9 
O / f ILL 


r eloop 


nextl 


o/, Til 


r eciov e 


UcA LUU V/ 




removl 


nex top 


Q7 


rename 


nex t lop 




reserve 


no 


Tl S T 1 ? 


restart 


no tes 




restore 


no wo rd 


T 1 

J i O 


re turn 


oR 


T 1 1^ Tl 9 
J 13 ) ill 


for it/ in 


0 kwo rd 


T 1 n 
J i fi 


ro tato 


OpBll 


J o 


ro ute 


or 


719 Tl 9 
JL Ly ILL 


ro utvar 


0 tOcL 


f'l 9 


r unu 


outloop 


C A T9 9 


rvec to r 


0 liLpUL 


n9 


say 


output}. 


n9 


sayc 


p ac k 


Oil) xD 


saylang 


U 2\,L. 




scalex 


par S& 


T?l 7 


sc aley 


p a us6i 


T9 9 


score 


LI C L 111 X u 




search 


play 


PI A 1 Q 


searc hf 


p J.O I. 


PS Tl Q 


seed 


polar 


Dl 9 

ri Z 


segment 


p p L aa a t 


T9 
iZ J 


segmen tf 


pp tclr 


TO 9 


send key 


pp LU a La 


T9A 
xzh 


set 


PP t load 


T9 9 

iZ J 


se tdat 


pp tout 


TO/. 


se tline 


pptrun 


TO/. 


se tname 


p p t te s t 


moo 
J. Z J 


se tperm 


press 


Ql 1 T99 
L ^ xL/ 


show 


put 




showa 


putd 




s ho wb 


Li ii L V 


TS 


showe 


rand p 




showh 


randu 


C8,T4 


showo 


rat 


P8,T19 


showt 


ratnm 


P8,T19 


s ho Wis 


rbox 


P3 


site 


rcircle 


P9 


size 


rdot 


P8,T19 


slide 


rdraw 


P8,T19 


sort 


readd 


D3 


sorta 





VAJ UllUCtLiU 






Spec s 






sea Lion 




CIS 


status 


P 9 

I\L 


P16,T19 


Step 


«>1 7 

D X / 


F7 


St olcad 


C21 


C2i,F3,Si6 


scop 


f^7 T9 9 

O / f XL -m 


S6,T22 


sto rage 


C20 


C9,T4 


store 


J 0 


S15 


storea 


Tfl 
J 0 


F4 


storen 


Tfi 


C21,F2,S16 storeu 


«J o 


D5 


s\i b 1 


OH 


C9 ""4 


L d u oc. L 


PI Q 

i X -7 




term 


DO 


P8,T19 


r p r m fin 


DO 


P4,T16 


tex t 


P*^ T16 

X J f X X\J 


Rl 


tex tn 


Tl 7 

XX / 


Rl 


time 


O X V 


Tl 

X X 


t imel 


Q1 
Di ^ 




L«L UlCJL 


Q 1 
D i 


PIS 


1 0 uc \x 


Tl 9 

«J X ^ 


P18 


r n\ic hw 

L« U \Ji Km* 11 W 


Tl 9 

«J X i. 


P18 


t ran sf r 


r 1 r< 

O X o 


P10,T19 


trap 


Tl Q 

X X !7 


P10,T19 


uni t 


^1 Tl 


R2,T21 


uni r,op 


<5 1 

D X 


C11,T5 


use 


^1 2 T22 


T6 


vbar 


P14, T19 


C8 


vector 


P7,T19 


CI 


vocab 


«J H 


CI 


vocabs 


TA 


T20 


windov; 


P7 


C4,T4 


write 


PI T15 

L X J X XJ 


D2 


writec 


P 1 TVS 

XX) X XJ 


F16 


wrong 


T Q n 1 

«J ^ J AAA 


F3,F14 


wrong c 


J10,X11 


C8,T4 


wrongu 


Jll 


P2,T15 


wrongv 


J11,T11 


P3,T16 


xin 


P17,T18 


T15 


xmit 


T20 


P2 


xout 


P17,T18 


P3,T16 


zero 


C4,T3 


P3,T15 




S17 


P2,T15 




S17 


?2 


>-f ormat 


S20' 


Ml 




SI 3 


^4,T16 


utiicor 


Tl 



P16,T19 
C14 
C14 



18G 



